aws-sdk-amplify 1.35.0 → 1.52.0

data/lib/aws-sdk-amplify/types.rb

@@ -34,11 +34,15 @@ module Aws::Amplify
     #   @return [String]
     #
     # @!attribute [rw] repository
-    #   The repository for the Amplify app.
+    #   The Git repository for the Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] platform
-    #   The platform for the Amplify app.
+    #   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`.
     #   @return [String]
     #
     # @!attribute [rw] create_time
@@ -56,6 +60,14 @@ module Aws::Amplify
     #
     # @!attribute [rw] environment_variables
     #   The environment variables for the Amplify app.
+    #
+    #   For a list of the environment variables that are accessible to
+    #   Amplify by default, see [Amplify Environment variables][1] in the
+    #   *Amplify Hosting User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amplify/latest/userguide/amplify-console-environment-variables.html
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] default_domain
@@ -67,7 +79,7 @@ module Aws::Amplify
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_branch_auto_deletion
-    #   Automatically disconnect a branch in the Amplify Console when you
+    #   Automatically disconnect a branch in the Amplify console when you
     #   delete a branch from your Git repository.
     #   @return [Boolean]
     #
@@ -77,7 +89,8 @@ module Aws::Amplify
     #
     # @!attribute [rw] basic_auth_credentials
     #   The basic authorization credentials for branches for the Amplify
-    #   app.
+    #   app. You must base64-encode the authorization credentials and
+    #   provide them in the format `user:password`.
     #   @return [String]
     #
     # @!attribute [rw] custom_rules
@@ -112,6 +125,18 @@ module Aws::Amplify
     #   Amplify app.
     #   @return [Types::AutoBranchCreationConfig]
     #
+    # @!attribute [rw] repository_clone_method
+    #   <note markdown="1"> This is for internal use.
+    #
+    #    </note>
+    #
+    #   The Amplify service uses this parameter to specify the
+    #   authentication protocol to use to access the Git repository for an
+    #   Amplify app. Amplify specifies `TOKEN` for a GitHub repository,
+    #   `SIGV4` for an Amazon Web Services CodeCommit repository, and `SSH`
+    #   for GitLab and Bitbucket repositories.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amplify-2017-07-25/App AWS API Documentation
     #
     class App < Struct.new(
@@ -137,8 +162,9 @@ module Aws::Amplify
       :custom_headers,
       :enable_auto_branch_creation,
       :auto_branch_creation_patterns,
-      :auto_branch_creation_config)
-      SENSITIVE = [:basic_auth_credentials]
+      :auto_branch_creation_config,
+      :repository_clone_method)
+      SENSITIVE = [:basic_auth_credentials, :build_spec]
       include Aws::Structure
     end
 
@@ -163,24 +189,6 @@ module Aws::Amplify
 
     # Describes the automated branch creation configuration.
     #
-    # @note When making an API call, you may pass AutoBranchCreationConfig
-    #   data as a hash:
-    #
-    #       {
-    #         stage: "PRODUCTION", # accepts PRODUCTION, BETA, DEVELOPMENT, EXPERIMENTAL, PULL_REQUEST
-    #         framework: "Framework",
-    #         enable_auto_build: false,
-    #         environment_variables: {
-    #           "EnvKey" => "EnvValue",
-    #         },
-    #         basic_auth_credentials: "BasicAuthCredentials",
-    #         enable_basic_auth: false,
-    #         enable_performance_mode: false,
-    #         build_spec: "BuildSpec",
-    #         enable_pull_request_preview: false,
-    #         pull_request_environment_name: "PullRequestEnvironmentName",
-    #       }
-    #
     # @!attribute [rw] stage
     #   Describes the current stage for the autocreated branch.
     #   @return [String]
@@ -198,7 +206,9 @@ module Aws::Amplify
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] basic_auth_credentials
-    #   The basic authorization credentials for the autocreated branch.
+    #   The basic authorization credentials for the autocreated branch. You
+    #   must base64-encode the authorization credentials and provide them in
+    #   the format `user:password`.
     #   @return [String]
     #
     # @!attribute [rw] enable_basic_auth
@@ -239,7 +249,21 @@ module Aws::Amplify
       :build_spec,
       :enable_pull_request_preview,
       :pull_request_environment_name)
-      SENSITIVE = [:basic_auth_credentials]
+      SENSITIVE = [:basic_auth_credentials, :build_spec]
+      include Aws::Structure
+    end
+
+    # Describes the backend properties associated with an Amplify `Branch`.
+    #
+    # @!attribute [rw] stack_arn
+    #   The Amazon Resource Name (ARN) for the CloudFormation stack.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/amplify-2017-07-25/Backend AWS API Documentation
+    #
+    class Backend < Struct.new(
+      :stack_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -384,6 +408,8 @@ module Aws::Amplify
     #
     # @!attribute [rw] basic_auth_credentials
     #   The basic authorization credentials for a branch of an Amplify app.
+    #   You must base64-encode the authorization credentials and provide
+    #   them in the format `user:password`.
     #   @return [String]
     #
     # @!attribute [rw] build_spec
@@ -420,6 +446,11 @@ module Aws::Amplify
     #   part of an Amplify app.
     #   @return [String]
     #
+    # @!attribute [rw] backend
+    #   Describes the backend properties associated with an Amplify
+    #   `Branch`.
+    #   @return [Types::Backend]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amplify-2017-07-25/Branch AWS API Documentation
     #
     class Branch < Struct.new(
@@ -449,76 +480,32 @@ module Aws::Amplify
       :pull_request_environment_name,
       :destination_branch,
       :source_branch,
-      :backend_environment_arn)
-      SENSITIVE = [:basic_auth_credentials]
+      :backend_environment_arn,
+      :backend)
+      SENSITIVE = [:basic_auth_credentials, :build_spec]
       include Aws::Structure
     end
 
     # The request structure used to create apps in Amplify.
     #
-    # @note When making an API call, you may pass CreateAppRequest
-    #   data as a hash:
-    #
-    #       {
-    #         name: "Name", # required
-    #         description: "Description",
-    #         repository: "Repository",
-    #         platform: "WEB", # accepts WEB
-    #         iam_service_role_arn: "ServiceRoleArn",
-    #         oauth_token: "OauthToken",
-    #         access_token: "AccessToken",
-    #         environment_variables: {
-    #           "EnvKey" => "EnvValue",
-    #         },
-    #         enable_branch_auto_build: false,
-    #         enable_branch_auto_deletion: false,
-    #         enable_basic_auth: false,
-    #         basic_auth_credentials: "BasicAuthCredentials",
-    #         custom_rules: [
-    #           {
-    #             source: "Source", # required
-    #             target: "Target", # required
-    #             status: "Status",
-    #             condition: "Condition",
-    #           },
-    #         ],
-    #         tags: {
-    #           "TagKey" => "TagValue",
-    #         },
-    #         build_spec: "BuildSpec",
-    #         custom_headers: "CustomHeaders",
-    #         enable_auto_branch_creation: false,
-    #         auto_branch_creation_patterns: ["AutoBranchCreationPattern"],
-    #         auto_branch_creation_config: {
-    #           stage: "PRODUCTION", # accepts PRODUCTION, BETA, DEVELOPMENT, EXPERIMENTAL, PULL_REQUEST
-    #           framework: "Framework",
-    #           enable_auto_build: false,
-    #           environment_variables: {
-    #             "EnvKey" => "EnvValue",
-    #           },
-    #           basic_auth_credentials: "BasicAuthCredentials",
-    #           enable_basic_auth: false,
-    #           enable_performance_mode: false,
-    #           build_spec: "BuildSpec",
-    #           enable_pull_request_preview: false,
-    #           pull_request_environment_name: "PullRequestEnvironmentName",
-    #         },
-    #       }
-    #
     # @!attribute [rw] name
-    #   The name for an Amplify app.
+    #   The name of the Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] description
-    #   The description for an Amplify app.
+    #   The description of the Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] repository
-    #   The repository for an Amplify app.
+    #   The Git repository for the Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] platform
-    #   The platform or framework for an Amplify app.
+    #   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`.
     #   @return [String]
     #
     # @!attribute [rw] iam_service_role_arn
@@ -529,17 +516,61 @@ module Aws::Amplify
     # @!attribute [rw] oauth_token
     #   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. The OAuth token is not stored.
+    #   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][1] in
+    #   the *Amplify User Guide* .
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amplify/latest/userguide/setting-up-GitHub-access.html#migrating-to-github-app-auth
     #   @return [String]
     #
     # @!attribute [rw] access_token
-    #   The personal access token for a third-party source control system
-    #   for an Amplify app. The personal access token is used to create a
-    #   webhook and a read-only deploy key. The token is not stored.
+    #   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][1] in
+    #   the *Amplify User Guide* .
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amplify/latest/userguide/setting-up-GitHub-access.html#migrating-to-github-app-auth
     #   @return [String]
     #
     # @!attribute [rw] environment_variables
     #   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][1] in the
+    #   *Amplify Hosting User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amplify/latest/userguide/amplify-console-environment-variables.html
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] enable_branch_auto_build
@@ -547,7 +578,7 @@ module Aws::Amplify
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_branch_auto_deletion
-    #   Automatically disconnects a branch in the Amplify Console when you
+    #   Automatically disconnects a branch in the Amplify console when you
     #   delete a branch from your Git repository.
     #   @return [Boolean]
     #
@@ -557,7 +588,9 @@ module Aws::Amplify
     #   @return [Boolean]
     #
     # @!attribute [rw] basic_auth_credentials
-    #   The credentials for basic authorization for an Amplify app.
+    #   The credentials for basic authorization for an Amplify app. You must
+    #   base64-encode the authorization credentials and provide them in the
+    #   format `user:password`.
     #   @return [String]
     #
     # @!attribute [rw] custom_rules
@@ -610,7 +643,7 @@ module Aws::Amplify
       :enable_auto_branch_creation,
       :auto_branch_creation_patterns,
       :auto_branch_creation_config)
-      SENSITIVE = [:oauth_token, :access_token, :basic_auth_credentials]
+      SENSITIVE = [:oauth_token, :access_token, :basic_auth_credentials, :build_spec]
       include Aws::Structure
     end
 
@@ -629,16 +662,6 @@ module Aws::Amplify
 
     # The request structure for the backend environment create request.
     #
-    # @note When making an API call, you may pass CreateBackendEnvironmentRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         environment_name: "EnvironmentName", # required
-    #         stack_name: "StackName",
-    #         deployment_artifacts: "DeploymentArtifacts",
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -682,34 +705,6 @@ module Aws::Amplify
 
     # The request structure for the create branch request.
     #
-    # @note When making an API call, you may pass CreateBranchRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         description: "Description",
-    #         stage: "PRODUCTION", # accepts PRODUCTION, BETA, DEVELOPMENT, EXPERIMENTAL, PULL_REQUEST
-    #         framework: "Framework",
-    #         enable_notification: false,
-    #         enable_auto_build: false,
-    #         environment_variables: {
-    #           "EnvKey" => "EnvValue",
-    #         },
-    #         basic_auth_credentials: "BasicAuthCredentials",
-    #         enable_basic_auth: false,
-    #         enable_performance_mode: false,
-    #         tags: {
-    #           "TagKey" => "TagValue",
-    #         },
-    #         build_spec: "BuildSpec",
-    #         ttl: "TTL",
-    #         display_name: "DisplayName",
-    #         enable_pull_request_preview: false,
-    #         pull_request_environment_name: "PullRequestEnvironmentName",
-    #         backend_environment_arn: "BackendEnvironmentArn",
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -743,7 +738,9 @@ module Aws::Amplify
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] basic_auth_credentials
-    #   The basic authorization credentials for the branch.
+    #   The basic authorization credentials for the branch. You must
+    #   base64-encode the authorization credentials and provide them in the
+    #   format `user:password`.
     #   @return [String]
     #
     # @!attribute [rw] enable_basic_auth
@@ -789,6 +786,11 @@ module Aws::Amplify
     #   part of an Amplify app.
     #   @return [String]
     #
+    # @!attribute [rw] backend
+    #   The backend for a `Branch` of an Amplify app. Use for a backend
+    #   created from an CloudFormation stack.
+    #   @return [Types::Backend]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amplify-2017-07-25/CreateBranchRequest AWS API Documentation
     #
     class CreateBranchRequest < Struct.new(
@@ -809,8 +811,9 @@ module Aws::Amplify
       :display_name,
       :enable_pull_request_preview,
       :pull_request_environment_name,
-      :backend_environment_arn)
-      SENSITIVE = [:basic_auth_credentials]
+      :backend_environment_arn,
+      :backend)
+      SENSITIVE = [:basic_auth_credentials, :build_spec]
       include Aws::Structure
     end
 
@@ -831,23 +834,12 @@ module Aws::Amplify
 
     # The request structure for the create a new deployment request.
     #
-    # @note When making an API call, you may pass CreateDeploymentRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         file_map: {
-    #           "FileName" => "MD5Hash",
-    #         },
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The name for the branch, for the job.
+    #   The name of the branch to use for the job.
     #   @return [String]
     #
     # @!attribute [rw] file_map
@@ -896,23 +888,6 @@ module Aws::Amplify
 
     # The request structure for the create domain association request.
     #
-    # @note When making an API call, you may pass CreateDomainAssociationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         domain_name: "DomainName", # required
-    #         enable_auto_sub_domain: false,
-    #         sub_domain_settings: [ # required
-    #           {
-    #             prefix: "DomainPrefix", # required
-    #             branch_name: "BranchName", # required
-    #           },
-    #         ],
-    #         auto_sub_domain_creation_patterns: ["AutoSubDomainCreationPattern"],
-    #         auto_sub_domain_iam_role: "AutoSubDomainIAMRole",
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -969,15 +944,6 @@ module Aws::Amplify
 
     # The request structure for the create webhook request.
     #
-    # @note When making an API call, you may pass CreateWebhookRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         description: "Description",
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -1017,16 +983,6 @@ module Aws::Amplify
 
     # Describes a custom rewrite or redirect rule.
     #
-    # @note When making an API call, you may pass CustomRule
-    #   data as a hash:
-    #
-    #       {
-    #         source: "Source", # required
-    #         target: "Target", # required
-    #         status: "Status",
-    #         condition: "Condition",
-    #       }
-    #
     # @!attribute [rw] source
     #   The source pattern for a URL rewrite or redirect rule.
     #   @return [String]
@@ -1078,13 +1034,6 @@ module Aws::Amplify
 
     # Describes the request structure for the delete app request.
     #
-    # @note When making an API call, you may pass DeleteAppRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -1114,14 +1063,6 @@ module Aws::Amplify
 
     # The request structure for the delete backend environment request.
     #
-    # @note When making an API call, you may pass DeleteBackendEnvironmentRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         environment_name: "EnvironmentName", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID of an Amplify app.
     #   @return [String]
@@ -1155,20 +1096,12 @@ module Aws::Amplify
 
     # The request structure for the delete branch request.
     #
-    # @note When making an API call, you may pass DeleteBranchRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The name for the branch.
+    #   The name of the branch.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amplify-2017-07-25/DeleteBranchRequest AWS API Documentation
@@ -1197,14 +1130,6 @@ module Aws::Amplify
 
     # The request structure for the delete domain association request.
     #
-    # @note When making an API call, you may pass DeleteDomainAssociationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         domain_name: "DomainName", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique id for an Amplify app.
     #   @return [String]
@@ -1237,21 +1162,12 @@ module Aws::Amplify
 
     # The request structure for the delete job request.
     #
-    # @note When making an API call, you may pass DeleteJobRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         job_id: "JobId", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The name for the branch, for the job.
+    #   The name of the branch to use for the job.
     #   @return [String]
     #
     # @!attribute [rw] job_id
@@ -1284,13 +1200,6 @@ module Aws::Amplify
 
     # The request structure for the delete webhook request.
     #
-    # @note When making an API call, you may pass DeleteWebhookRequest
-    #   data as a hash:
-    #
-    #       {
-    #         webhook_id: "WebhookId", # required
-    #       }
-    #
     # @!attribute [rw] webhook_id
     #   The unique ID for a webhook.
     #   @return [String]
@@ -1390,16 +1299,6 @@ module Aws::Amplify
 
     # The request structure for the generate access logs request.
     #
-    # @note When making an API call, you may pass GenerateAccessLogsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         start_time: Time.now,
-    #         end_time: Time.now,
-    #         domain_name: "DomainName", # required
-    #         app_id: "AppId", # required
-    #       }
-    #
     # @!attribute [rw] start_time
     #   The time at which the logs should start. The time range specified is
     #   inclusive of the start time.
@@ -1445,13 +1344,6 @@ module Aws::Amplify
 
     # The request structure for the get app request.
     #
-    # @note When making an API call, you may pass GetAppRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -1479,13 +1371,6 @@ module Aws::Amplify
 
     # Returns the request structure for the get artifact request.
     #
-    # @note When making an API call, you may pass GetArtifactUrlRequest
-    #   data as a hash:
-    #
-    #       {
-    #         artifact_id: "ArtifactId", # required
-    #       }
-    #
     # @!attribute [rw] artifact_id
     #   The unique ID for an artifact.
     #   @return [String]
@@ -1519,14 +1404,6 @@ module Aws::Amplify
 
     # The request structure for the get backend environment request.
     #
-    # @note When making an API call, you may pass GetBackendEnvironmentRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         environment_name: "EnvironmentName", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique id for an Amplify app.
     #   @return [String]
@@ -1560,20 +1437,12 @@ module Aws::Amplify
 
     # The request structure for the get branch request.
     #
-    # @note When making an API call, you may pass GetBranchRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The name for the branch.
+    #   The name of the branch.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amplify-2017-07-25/GetBranchRequest AWS API Documentation
@@ -1600,14 +1469,6 @@ module Aws::Amplify
 
     # The request structure for the get domain association request.
     #
-    # @note When making an API call, you may pass GetDomainAssociationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         domain_name: "DomainName", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique id for an Amplify app.
     #   @return [String]
@@ -1642,21 +1503,12 @@ module Aws::Amplify
 
     # The request structure for the get job request.
     #
-    # @note When making an API call, you may pass GetJobRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         job_id: "JobId", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The branch name for the job.
+    #   The name of the branch to use for the job.
     #   @return [String]
     #
     # @!attribute [rw] job_id
@@ -1687,13 +1539,6 @@ module Aws::Amplify
 
     # The request structure for the get webhook request.
     #
-    # @note When making an API call, you may pass GetWebhookRequest
-    #   data as a hash:
-    #
-    #       {
-    #         webhook_id: "WebhookId", # required
-    #       }
-    #
     # @!attribute [rw] webhook_id
     #   The unique ID for a webhook.
     #   @return [String]
@@ -1826,14 +1671,6 @@ module Aws::Amplify
 
     # The request structure for the list apps request.
     #
-    # @note When making an API call, you may pass ListAppsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         next_token: "NextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] next_token
     #   A pagination token. If non-null, the pagination token is returned in
     #   a result. Pass its value in another request to retrieve more
@@ -1876,17 +1713,6 @@ module Aws::Amplify
 
     # Describes the request structure for the list artifacts request.
     #
-    # @note When making an API call, you may pass ListArtifactsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         job_id: "JobId", # required
-    #         next_token: "NextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -1943,16 +1769,6 @@ module Aws::Amplify
 
     # The request structure for the list backend environments request.
     #
-    # @note When making an API call, you may pass ListBackendEnvironmentsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         environment_name: "EnvironmentName",
-    #         next_token: "NextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -2005,15 +1821,6 @@ module Aws::Amplify
 
     # The request structure for the list branches request.
     #
-    # @note When making an API call, you may pass ListBranchesRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         next_token: "NextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -2060,15 +1867,6 @@ module Aws::Amplify
 
     # The request structure for the list domain associations request.
     #
-    # @note When making an API call, you may pass ListDomainAssociationsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         next_token: "NextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -2115,22 +1913,12 @@ module Aws::Amplify
 
     # The request structure for the list jobs request.
     #
-    # @note When making an API call, you may pass ListJobsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         next_token: "NextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The name for a branch.
+    #   The name of the branch to use for the request.
     #   @return [String]
     #
     # @!attribute [rw] next_token
@@ -2177,13 +1965,6 @@ module Aws::Amplify
 
     # The request structure to use to list tags for a resource.
     #
-    # @note When making an API call, you may pass ListTagsForResourceRequest
-    #   data as a hash:
-    #
-    #       {
-    #         resource_arn: "ResourceArn", # required
-    #       }
-    #
     # @!attribute [rw] resource_arn
     #   The Amazon Resource Name (ARN) to use to list tags.
     #   @return [String]
@@ -2212,15 +1993,6 @@ module Aws::Amplify
 
     # The request structure for the list webhooks request.
     #
-    # @note When making an API call, you may pass ListWebhooksRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         next_token: "NextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -2328,22 +2100,12 @@ module Aws::Amplify
 
     # The request structure for the start a deployment request.
     #
-    # @note When making an API call, you may pass StartDeploymentRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         job_id: "JobId",
-    #         source_url: "SourceUrl",
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The name for the branch, for the job.
+    #   The name of the branch to use for the job.
     #   @return [String]
     #
     # @!attribute [rw] job_id
@@ -2385,26 +2147,12 @@ module Aws::Amplify
 
     # The request structure for the start job request.
     #
-    # @note When making an API call, you may pass StartJobRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         job_id: "JobId",
-    #         job_type: "RELEASE", # required, accepts RELEASE, RETRY, MANUAL, WEB_HOOK
-    #         job_reason: "JobReason",
-    #         commit_id: "CommitId",
-    #         commit_message: "CommitMessage",
-    #         commit_time: Time.now,
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The branch name for the job.
+    #   The name of the branch to use for the job.
     #   @return [String]
     #
     # @!attribute [rw] job_id
@@ -2415,13 +2163,14 @@ module Aws::Amplify
     # @!attribute [rw] job_type
     #   Describes the type for the job. The job type `RELEASE` starts a new
     #   job with the latest change from the specified branch. This value is
-    #   available only for apps that are connected to a repository. The job
-    #   type `RETRY` retries an existing job. If the job type value is
-    #   `RETRY`, the `jobId` is also required.
+    #   available only for apps that are connected to a repository.
+    #
+    #   The job type `RETRY` retries an existing job. If the job type value
+    #   is `RETRY`, the `jobId` is also required.
     #   @return [String]
     #
     # @!attribute [rw] job_reason
-    #   A descriptive reason for starting this job.
+    #   A descriptive reason for starting the job.
     #   @return [String]
     #
     # @!attribute [rw] commit_id
@@ -2533,21 +2282,12 @@ module Aws::Amplify
 
     # The request structure for the stop job request.
     #
-    # @note When making an API call, you may pass StopJobRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         job_id: "JobId", # required
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The name for the branch, for the job.
+    #   The name of the branch to use for the stop job request.
     #   @return [String]
     #
     # @!attribute [rw] job_id
@@ -2604,14 +2344,6 @@ module Aws::Amplify
 
     # Describes the settings for the subdomain.
     #
-    # @note When making an API call, you may pass SubDomainSetting
-    #   data as a hash:
-    #
-    #       {
-    #         prefix: "DomainPrefix", # required
-    #         branch_name: "BranchName", # required
-    #       }
-    #
     # @!attribute [rw] prefix
     #   The prefix setting for the subdomain.
     #   @return [String]
@@ -2631,16 +2363,6 @@ module Aws::Amplify
 
     # The request structure to tag a resource with a tag key and value.
     #
-    # @note When making an API call, you may pass TagResourceRequest
-    #   data as a hash:
-    #
-    #       {
-    #         resource_arn: "ResourceArn", # required
-    #         tags: { # required
-    #           "TagKey" => "TagValue",
-    #         },
-    #       }
-    #
     # @!attribute [rw] resource_arn
     #   The Amazon Resource Name (ARN) to use to tag a resource.
     #   @return [String]
@@ -2679,14 +2401,6 @@ module Aws::Amplify
 
     # The request structure for the untag resource request.
     #
-    # @note When making an API call, you may pass UntagResourceRequest
-    #   data as a hash:
-    #
-    #       {
-    #         resource_arn: "ResourceArn", # required
-    #         tag_keys: ["TagKey"], # required
-    #       }
-    #
     # @!attribute [rw] resource_arn
     #   The Amazon Resource Name (ARN) to use to untag a resource.
     #   @return [String]
@@ -2712,53 +2426,6 @@ module Aws::Amplify
 
     # The request structure for the update app request.
     #
-    # @note When making an API call, you may pass UpdateAppRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         name: "Name",
-    #         description: "Description",
-    #         platform: "WEB", # accepts WEB
-    #         iam_service_role_arn: "ServiceRoleArn",
-    #         environment_variables: {
-    #           "EnvKey" => "EnvValue",
-    #         },
-    #         enable_branch_auto_build: false,
-    #         enable_branch_auto_deletion: false,
-    #         enable_basic_auth: false,
-    #         basic_auth_credentials: "BasicAuthCredentials",
-    #         custom_rules: [
-    #           {
-    #             source: "Source", # required
-    #             target: "Target", # required
-    #             status: "Status",
-    #             condition: "Condition",
-    #           },
-    #         ],
-    #         build_spec: "BuildSpec",
-    #         custom_headers: "CustomHeaders",
-    #         enable_auto_branch_creation: false,
-    #         auto_branch_creation_patterns: ["AutoBranchCreationPattern"],
-    #         auto_branch_creation_config: {
-    #           stage: "PRODUCTION", # accepts PRODUCTION, BETA, DEVELOPMENT, EXPERIMENTAL, PULL_REQUEST
-    #           framework: "Framework",
-    #           enable_auto_build: false,
-    #           environment_variables: {
-    #             "EnvKey" => "EnvValue",
-    #           },
-    #           basic_auth_credentials: "BasicAuthCredentials",
-    #           enable_basic_auth: false,
-    #           enable_performance_mode: false,
-    #           build_spec: "BuildSpec",
-    #           enable_pull_request_preview: false,
-    #           pull_request_environment_name: "PullRequestEnvironmentName",
-    #         },
-    #         repository: "Repository",
-    #         oauth_token: "OauthToken",
-    #         access_token: "AccessToken",
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -2772,7 +2439,11 @@ module Aws::Amplify
     #   @return [String]
     #
     # @!attribute [rw] platform
-    #   The platform for an Amplify app.
+    #   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`.
     #   @return [String]
     #
     # @!attribute [rw] iam_service_role_arn
@@ -2789,7 +2460,7 @@ module Aws::Amplify
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_branch_auto_deletion
-    #   Automatically disconnects a branch in the Amplify Console when you
+    #   Automatically disconnects a branch in the Amplify console when you
     #   delete a branch from your Git repository.
     #   @return [Boolean]
     #
@@ -2798,7 +2469,9 @@ module Aws::Amplify
     #   @return [Boolean]
     #
     # @!attribute [rw] basic_auth_credentials
-    #   The basic authorization credentials for an Amplify app.
+    #   The basic authorization credentials for an Amplify app. You must
+    #   base64-encode the authorization credentials and provide them in the
+    #   format `user:password`.
     #   @return [String]
     #
     # @!attribute [rw] custom_rules
@@ -2827,19 +2500,57 @@ module Aws::Amplify
     #   @return [Types::AutoBranchCreationConfig]
     #
     # @!attribute [rw] repository
-    #   The name of the repository for an Amplify app
+    #   The name of the Git repository for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] oauth_token
     #   The OAuth token for a third-party source control system for an
-    #   Amplify app. The token is used to create a webhook and a read-only
-    #   deploy key. The OAuth token is not stored.
+    #   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
+    #   update an 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][1] in
+    #   the *Amplify User Guide* .
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amplify/latest/userguide/setting-up-GitHub-access.html#migrating-to-github-app-auth
     #   @return [String]
     #
     # @!attribute [rw] access_token
-    #   The personal access token for a third-party source control system
-    #   for an Amplify app. The token is used to create webhook and a
-    #   read-only deploy key. The token is not stored.
+    #   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
+    #   update an 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][1] in
+    #   the *Amplify User Guide* .
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amplify/latest/userguide/setting-up-GitHub-access.html#migrating-to-github-app-auth
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amplify-2017-07-25/UpdateAppRequest AWS API Documentation
@@ -2864,7 +2575,7 @@ module Aws::Amplify
       :repository,
       :oauth_token,
       :access_token)
-      SENSITIVE = [:basic_auth_credentials, :oauth_token, :access_token]
+      SENSITIVE = [:basic_auth_credentials, :build_spec, :oauth_token, :access_token]
       include Aws::Structure
     end
 
@@ -2884,37 +2595,12 @@ module Aws::Amplify
 
     # The request structure for the update branch request.
     #
-    # @note When making an API call, you may pass UpdateBranchRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         branch_name: "BranchName", # required
-    #         description: "Description",
-    #         framework: "Framework",
-    #         stage: "PRODUCTION", # accepts PRODUCTION, BETA, DEVELOPMENT, EXPERIMENTAL, PULL_REQUEST
-    #         enable_notification: false,
-    #         enable_auto_build: false,
-    #         environment_variables: {
-    #           "EnvKey" => "EnvValue",
-    #         },
-    #         basic_auth_credentials: "BasicAuthCredentials",
-    #         enable_basic_auth: false,
-    #         enable_performance_mode: false,
-    #         build_spec: "BuildSpec",
-    #         ttl: "TTL",
-    #         display_name: "DisplayName",
-    #         enable_pull_request_preview: false,
-    #         pull_request_environment_name: "PullRequestEnvironmentName",
-    #         backend_environment_arn: "BackendEnvironmentArn",
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
     #
     # @!attribute [rw] branch_name
-    #   The name for the branch.
+    #   The name of the branch.
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -2942,7 +2628,9 @@ module Aws::Amplify
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] basic_auth_credentials
-    #   The basic authorization credentials for the branch.
+    #   The basic authorization credentials for the branch. You must
+    #   base64-encode the authorization credentials and provide them in the
+    #   format `user:password`.
     #   @return [String]
     #
     # @!attribute [rw] enable_basic_auth
@@ -2984,6 +2672,11 @@ module Aws::Amplify
     #   part of an Amplify app.
     #   @return [String]
     #
+    # @!attribute [rw] backend
+    #   The backend for a `Branch` of an Amplify app. Use for a backend
+    #   created from an CloudFormation stack.
+    #   @return [Types::Backend]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amplify-2017-07-25/UpdateBranchRequest AWS API Documentation
     #
     class UpdateBranchRequest < Struct.new(
@@ -3003,8 +2696,9 @@ module Aws::Amplify
       :display_name,
       :enable_pull_request_preview,
       :pull_request_environment_name,
-      :backend_environment_arn)
-      SENSITIVE = [:basic_auth_credentials]
+      :backend_environment_arn,
+      :backend)
+      SENSITIVE = [:basic_auth_credentials, :build_spec]
       include Aws::Structure
     end
 
@@ -3025,23 +2719,6 @@ module Aws::Amplify
 
     # The request structure for the update domain association request.
     #
-    # @note When making an API call, you may pass UpdateDomainAssociationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         app_id: "AppId", # required
-    #         domain_name: "DomainName", # required
-    #         enable_auto_sub_domain: false,
-    #         sub_domain_settings: [ # required
-    #           {
-    #             prefix: "DomainPrefix", # required
-    #             branch_name: "BranchName", # required
-    #           },
-    #         ],
-    #         auto_sub_domain_creation_patterns: ["AutoSubDomainCreationPattern"],
-    #         auto_sub_domain_iam_role: "AutoSubDomainIAMRole",
-    #       }
-    #
     # @!attribute [rw] app_id
     #   The unique ID for an Amplify app.
     #   @return [String]
@@ -3098,15 +2775,6 @@ module Aws::Amplify
 
     # The request structure for the update webhook request.
     #
-    # @note When making an API call, you may pass UpdateWebhookRequest
-    #   data as a hash:
-    #
-    #       {
-    #         webhook_id: "WebhookId", # required
-    #         branch_name: "BranchName",
-    #         description: "Description",
-    #       }
-    #
     # @!attribute [rw] webhook_id
     #   The unique ID for a webhook.
     #   @return [String]