aws-sdk-appsync 1.58.0 → 1.60.0

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

@@ -66,13 +66,13 @@ module Aws::AppSync
     # @!attribute [rw] association_status
     #   Identifies the status of an association.
     #
-    #   * **PROCESSING**\: The API association is being created. You cannot
+    #   * **PROCESSING**: The API association is being created. You cannot
     #     modify association requests during processing.
     #
-    #   * **SUCCESS**\: The API association was successful. You can modify
+    #   * **SUCCESS**: The API association was successful. You can modify
     #     associations after success.
     #
-    #   * **FAILED**\: The API association has failed. You can modify
+    #   * **FAILED**: The API association has failed. You can modify
     #     associations after failure.
     #   @return [String]
     #
@@ -102,9 +102,9 @@ module Aws::AppSync
     # @!attribute [rw] api_caching_behavior
     #   Caching behavior.
     #
-    #   * **FULL\_REQUEST\_CACHING**\: All requests are fully cached.
+    #   * **FULL\_REQUEST\_CACHING**: All requests are fully cached.
     #
-    #   * **PER\_RESOLVER\_CACHING**\: Individual resolvers that you specify
+    #   * **PER\_RESOLVER\_CACHING**: Individual resolvers that you specify
     #     are cached.
     #   @return [String]
     #
@@ -144,33 +144,33 @@ module Aws::AppSync
     #   The following legacy instance types are available, but their use is
     #   discouraged:
     #
-    #   * **T2\_SMALL**\: A t2.small instance type.
+    #   * **T2\_SMALL**: A t2.small instance type.
     #
-    #   * **T2\_MEDIUM**\: A t2.medium instance type.
+    #   * **T2\_MEDIUM**: A t2.medium instance type.
     #
-    #   * **R4\_LARGE**\: A r4.large instance type.
+    #   * **R4\_LARGE**: A r4.large instance type.
     #
-    #   * **R4\_XLARGE**\: A r4.xlarge instance type.
+    #   * **R4\_XLARGE**: A r4.xlarge instance type.
     #
-    #   * **R4\_2XLARGE**\: A r4.2xlarge instance type.
+    #   * **R4\_2XLARGE**: A r4.2xlarge instance type.
     #
-    #   * **R4\_4XLARGE**\: A r4.4xlarge instance type.
+    #   * **R4\_4XLARGE**: A r4.4xlarge instance type.
     #
-    #   * **R4\_8XLARGE**\: A r4.8xlarge instance type.
+    #   * **R4\_8XLARGE**: A r4.8xlarge instance type.
     #   @return [String]
     #
     # @!attribute [rw] status
     #   The cache instance status.
     #
-    #   * **AVAILABLE**\: The instance is available for use.
+    #   * **AVAILABLE**: The instance is available for use.
     #
-    #   * **CREATING**\: The instance is currently creating.
+    #   * **CREATING**: The instance is currently creating.
     #
-    #   * **DELETING**\: The instance is currently deleting.
+    #   * **DELETING**: The instance is currently deleting.
     #
-    #   * **MODIFYING**\: The instance is currently modifying.
+    #   * **MODIFYING**: The instance is currently modifying.
     #
-    #   * **FAILED**\: The instance has failed creation.
+    #   * **FAILED**: The instance has failed creation.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ApiCache AWS API Documentation
@@ -191,7 +191,7 @@ module Aws::AppSync
     # Customers invoke AppSync GraphQL API operations with API keys as an
     # identity mechanism. There are two key versions:
     #
-    # **da1**\: We introduced this version at launch in November 2017. These
+    # **da1**: We introduced this version at launch in November 2017. These
     # keys always expire after 7 days. Amazon DynamoDB TTL manages key
     # expiration. These keys ceased to be valid after February 21, 2018, and
     # they should no longer be used.
@@ -209,7 +209,7 @@ module Aws::AppSync
     #   expects the TTL to be stored in seconds. As a one-time action, we
     #   deleted these keys from the table on February 21, 2018.
     #
-    # **da2**\: We introduced this version in February 2018 when AppSync
+    # **da2**: We introduced this version in February 2018 when AppSync
     # added support to extend key expiration.
     #
     # * `ListApiKeys` returns the expiration time and deletion time in
@@ -332,7 +332,7 @@ module Aws::AppSync
     #   @return [String]
     #
     # @!attribute [rw] api_id
-    #   The API ID.
+    #   The API ID. Private APIs can not be associated with custom domains.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/AssociateApiRequest AWS API Documentation
@@ -356,13 +356,107 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # @!attribute [rw] source_api_identifier
+    #   The identifier of the AppSync Source API. This is generated by the
+    #   AppSync service. In most cases, source APIs (especially in your
+    #   account) only require the API ID value or ARN of the source API.
+    #   However, source APIs from other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the source API.
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_identifier
+    #   The identifier of the AppSync Merged API. This is generated by the
+    #   AppSync service. In most cases, Merged APIs (especially in your
+    #   account) only require the API ID value or ARN of the merged API.
+    #   However, Merged APIs in other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description field.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_association_config
+    #   The `SourceApiAssociationConfig` object data.
+    #   @return [Types::SourceApiAssociationConfig]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/AssociateMergedGraphqlApiRequest AWS API Documentation
+    #
+    class AssociateMergedGraphqlApiRequest < Struct.new(
+      :source_api_identifier,
+      :merged_api_identifier,
+      :description,
+      :source_api_association_config)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] source_api_association
+    #   The `SourceApiAssociation` object data.
+    #   @return [Types::SourceApiAssociation]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/AssociateMergedGraphqlApiResponse AWS API Documentation
+    #
+    class AssociateMergedGraphqlApiResponse < Struct.new(
+      :source_api_association)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] merged_api_identifier
+    #   The identifier of the AppSync Merged API. This is generated by the
+    #   AppSync service. In most cases, Merged APIs (especially in your
+    #   account) only require the API ID value or ARN of the merged API.
+    #   However, Merged APIs in other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_identifier
+    #   The identifier of the AppSync Source API. This is generated by the
+    #   AppSync service. In most cases, source APIs (especially in your
+    #   account) only require the API ID value or ARN of the source API.
+    #   However, source APIs from other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the source API.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description field.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_association_config
+    #   The `SourceApiAssociationConfig` object data.
+    #   @return [Types::SourceApiAssociationConfig]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/AssociateSourceGraphqlApiRequest AWS API Documentation
+    #
+    class AssociateSourceGraphqlApiRequest < Struct.new(
+      :merged_api_identifier,
+      :source_api_identifier,
+      :description,
+      :source_api_association_config)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] source_api_association
+    #   The `SourceApiAssociation` object data.
+    #   @return [Types::SourceApiAssociation]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/AssociateSourceGraphqlApiResponse AWS API Documentation
+    #
+    class AssociateSourceGraphqlApiResponse < Struct.new(
+      :source_api_association)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The authorization configuration in case the HTTP endpoint requires
     # authorization.
     #
     # @!attribute [rw] authorization_type
     #   The authorization type that the HTTP endpoint requires.
     #
-    #   * **AWS\_IAM**\: The authorization type is Signature Version 4
+    #   * **AWS\_IAM**: The authorization type is Signature Version 4
     #     (SigV4).
     #
     #   ^
@@ -586,9 +680,9 @@ module Aws::AppSync
     # @!attribute [rw] api_caching_behavior
     #   Caching behavior.
     #
-    #   * **FULL\_REQUEST\_CACHING**\: All requests are fully cached.
+    #   * **FULL\_REQUEST\_CACHING**: All requests are fully cached.
     #
-    #   * **PER\_RESOLVER\_CACHING**\: Individual resolvers that you specify
+    #   * **PER\_RESOLVER\_CACHING**: Individual resolvers that you specify
     #     are cached.
     #   @return [String]
     #
@@ -618,19 +712,19 @@ module Aws::AppSync
     #   The following legacy instance types are available, but their use is
     #   discouraged:
     #
-    #   * **T2\_SMALL**\: A t2.small instance type.
+    #   * **T2\_SMALL**: A t2.small instance type.
     #
-    #   * **T2\_MEDIUM**\: A t2.medium instance type.
+    #   * **T2\_MEDIUM**: A t2.medium instance type.
     #
-    #   * **R4\_LARGE**\: A r4.large instance type.
+    #   * **R4\_LARGE**: A r4.large instance type.
     #
-    #   * **R4\_XLARGE**\: A r4.xlarge instance type.
+    #   * **R4\_XLARGE**: A r4.xlarge instance type.
     #
-    #   * **R4\_2XLARGE**\: A r4.2xlarge instance type.
+    #   * **R4\_2XLARGE**: A r4.2xlarge instance type.
     #
-    #   * **R4\_4XLARGE**\: A r4.4xlarge instance type.
+    #   * **R4\_4XLARGE**: A r4.4xlarge instance type.
     #
-    #   * **R4\_8XLARGE**\: A r4.8xlarge instance type.
+    #   * **R4\_8XLARGE**: A r4.8xlarge instance type.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/CreateApiCacheRequest AWS API Documentation
@@ -942,6 +1036,33 @@ module Aws::AppSync
     #   Configuration for Lambda function authorization.
     #   @return [Types::LambdaAuthorizerConfig]
     #
+    # @!attribute [rw] visibility
+    #   Sets the value of the GraphQL API to public (`GLOBAL`) or private
+    #   (`PRIVATE`). If no value is provided, the visibility will be set to
+    #   `GLOBAL` by default. This value cannot be changed once the API has
+    #   been created.
+    #   @return [String]
+    #
+    # @!attribute [rw] api_type
+    #   The value that indicates whether the GraphQL API is a standard API
+    #   (`GRAPHQL`) or merged API (`MERGED`).
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_execution_role_arn
+    #   The Identity and Access Management service role ARN for a merged
+    #   API. The AppSync service assumes this role on behalf of the Merged
+    #   API to validate access to source APIs at runtime and to prompt the
+    #   `AUTO_MERGE` to update the merged API endpoint with the source API
+    #   changes automatically.
+    #   @return [String]
+    #
+    # @!attribute [rw] owner_contact
+    #   The owner contact information for an API resource.
+    #
+    #   This field accepts any string input with a length of 0 - 256
+    #   characters.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/CreateGraphqlApiRequest AWS API Documentation
     #
     class CreateGraphqlApiRequest < Struct.new(
@@ -953,7 +1074,11 @@ module Aws::AppSync
       :tags,
       :additional_authentication_providers,
       :xray_enabled,
-      :lambda_authorizer_config)
+      :lambda_authorizer_config,
+      :visibility,
+      :api_type,
+      :merged_api_execution_role_arn,
+      :owner_contact)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1005,11 +1130,11 @@ module Aws::AppSync
     # @!attribute [rw] kind
     #   The resolver type.
     #
-    #   * **UNIT**\: A UNIT resolver type. A UNIT resolver is the default
+    #   * **UNIT**: A UNIT resolver type. A UNIT resolver is the default
     #     resolver type. You can use a UNIT resolver to run a GraphQL query
     #     against a single data source.
     #
-    #   * **PIPELINE**\: A PIPELINE resolver type. You can use a PIPELINE
+    #   * **PIPELINE**: A PIPELINE resolver type. You can use a PIPELINE
     #     resolver to invoke a series of `Function` objects in a serial
     #     manner. You can use a pipeline resolver to run a GraphQL query
     #     against multiple data sources.
@@ -1134,28 +1259,27 @@ module Aws::AppSync
     # @!attribute [rw] type
     #   The type of the data source.
     #
-    #   * **AWS\_LAMBDA**\: The data source is an Lambda function.
+    #   * **AWS\_LAMBDA**: The data source is an Lambda function.
     #
-    #   * **AMAZON\_DYNAMODB**\: The data source is an Amazon DynamoDB
-    #     table.
+    #   * **AMAZON\_DYNAMODB**: The data source is an Amazon DynamoDB table.
     #
-    #   * **AMAZON\_ELASTICSEARCH**\: The data source is an Amazon
-    #     OpenSearch Service domain.
+    #   * **AMAZON\_ELASTICSEARCH**: The data source is an Amazon OpenSearch
+    #     Service domain.
     #
-    #   * **AMAZON\_OPENSEARCH\_SERVICE**\: The data source is an Amazon
+    #   * **AMAZON\_OPENSEARCH\_SERVICE**: The data source is an Amazon
     #     OpenSearch Service domain.
     #
-    #   * **AMAZON\_EVENTBRIDGE**\: The data source is an Amazon EventBridge
+    #   * **AMAZON\_EVENTBRIDGE**: The data source is an Amazon EventBridge
     #     configuration.
     #
-    #   * **NONE**\: There is no data source. Use this type when you want to
+    #   * **NONE**: There is no data source. Use this type when you want to
     #     invoke a GraphQL operation without connecting to a data source,
     #     such as when you're performing data transformation with resolvers
     #     or invoking a subscription from a mutation.
     #
-    #   * **HTTP**\: The data source is an HTTP endpoint.
+    #   * **HTTP**: The data source is an HTTP endpoint.
     #
-    #   * **RELATIONAL\_DATABASE**\: The data source is a relational
+    #   * **RELATIONAL\_DATABASE**: The data source is a relational
     #     database.
     #   @return [String]
     #
@@ -1415,6 +1539,74 @@ module Aws::AppSync
     #
     class DisassociateApiResponse < Aws::EmptyStructure; end
 
+    # @!attribute [rw] source_api_identifier
+    #   The identifier of the AppSync Source API. This is generated by the
+    #   AppSync service. In most cases, source APIs (especially in your
+    #   account) only require the API ID value or ARN of the source API.
+    #   However, source APIs from other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the source API.
+    #   @return [String]
+    #
+    # @!attribute [rw] association_id
+    #   The ID generated by the AppSync service for the source API
+    #   association.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/DisassociateMergedGraphqlApiRequest AWS API Documentation
+    #
+    class DisassociateMergedGraphqlApiRequest < Struct.new(
+      :source_api_identifier,
+      :association_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] source_api_association_status
+    #   The state of the source API association.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/DisassociateMergedGraphqlApiResponse AWS API Documentation
+    #
+    class DisassociateMergedGraphqlApiResponse < Struct.new(
+      :source_api_association_status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] merged_api_identifier
+    #   The identifier of the AppSync Merged API. This is generated by the
+    #   AppSync service. In most cases, Merged APIs (especially in your
+    #   account) only require the API ID value or ARN of the merged API.
+    #   However, Merged APIs in other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] association_id
+    #   The ID generated by the AppSync service for the source API
+    #   association.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/DisassociateSourceGraphqlApiRequest AWS API Documentation
+    #
+    class DisassociateSourceGraphqlApiRequest < Struct.new(
+      :merged_api_identifier,
+      :association_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] source_api_association_status
+    #   The state of the source API association.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/DisassociateSourceGraphqlApiResponse AWS API Documentation
+    #
+    class DisassociateSourceGraphqlApiResponse < Struct.new(
+      :source_api_association_status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes a configuration for a custom domain.
     #
     # @!attribute [rw] domain_name
@@ -2025,6 +2217,40 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # @!attribute [rw] merged_api_identifier
+    #   The identifier of the AppSync Merged API. This is generated by the
+    #   AppSync service. In most cases, Merged APIs (especially in your
+    #   account) only require the API ID value or ARN of the merged API.
+    #   However, Merged APIs in other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] association_id
+    #   The ID generated by the AppSync service for the source API
+    #   association.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetSourceApiAssociationRequest AWS API Documentation
+    #
+    class GetSourceApiAssociationRequest < Struct.new(
+      :merged_api_identifier,
+      :association_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] source_api_association
+    #   The `SourceApiAssociation` object data.
+    #   @return [Types::SourceApiAssociation]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetSourceApiAssociationResponse AWS API Documentation
+    #
+    class GetSourceApiAssociationResponse < Struct.new(
+      :source_api_association)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] api_id
     #   The API ID.
     #   @return [String]
@@ -2129,6 +2355,41 @@ module Aws::AppSync
     #   Configuration for Lambda function authorization.
     #   @return [Types::LambdaAuthorizerConfig]
     #
+    # @!attribute [rw] dns
+    #   The DNS records for the API.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] visibility
+    #   Sets the value of the GraphQL API to public (`GLOBAL`) or private
+    #   (`PRIVATE`). If no value is provided, the visibility will be set to
+    #   `GLOBAL` by default. This value cannot be changed once the API has
+    #   been created.
+    #   @return [String]
+    #
+    # @!attribute [rw] api_type
+    #   The value that indicates whether the GraphQL API is a standard API
+    #   (`GRAPHQL`) or merged API (`MERGED`).
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_execution_role_arn
+    #   The Identity and Access Management service role ARN for a merged
+    #   API. The AppSync service assumes this role on behalf of the Merged
+    #   API to validate access to source APIs at runtime and to prompt the
+    #   `AUTO_MERGE` to update the merged API endpoint with the source API
+    #   changes automatically.
+    #   @return [String]
+    #
+    # @!attribute [rw] owner
+    #   The account owner of the GraphQL API.
+    #   @return [String]
+    #
+    # @!attribute [rw] owner_contact
+    #   The owner contact information for an API resource.
+    #
+    #   This field accepts any string input with a length of 0 - 256
+    #   characters.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GraphqlApi AWS API Documentation
     #
     class GraphqlApi < Struct.new(
@@ -2144,7 +2405,13 @@ module Aws::AppSync
       :additional_authentication_providers,
       :xray_enabled,
       :waf_web_acl_arn,
-      :lambda_authorizer_config)
+      :lambda_authorizer_config,
+      :dns,
+      :visibility,
+      :api_type,
+      :merged_api_execution_role_arn,
+      :owner,
+      :owner_contact)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2191,9 +2458,10 @@ module Aws::AppSync
     #
     # @!attribute [rw] authorizer_result_ttl_in_seconds
     #   The number of seconds a response should be cached for. The default
-    #   is 5 minutes (300 seconds). The Lambda function can override this by
-    #   returning a `ttlOverride` key in its response. A value of 0 disables
-    #   caching of responses.
+    #   is 0 seconds, which disables caching. If you don't specify a value
+    #   for `authorizerResultTtlInSeconds`, the default value is used. The
+    #   maximum value is one hour (3600 seconds). The Lambda function can
+    #   override this by returning a `ttlOverride` key in its response.
     #   @return [Integer]
     #
     # @!attribute [rw] authorizer_uri
@@ -2201,7 +2469,7 @@ module Aws::AppSync
     #   for authorization. This can be a standard Lambda ARN, a version ARN
     #   (`.../v3`), or an alias ARN.
     #
-    #   **Note**\: This Lambda function must have the following
+    #   **Note**: This Lambda function must have the following
     #   resource-based policy assigned to it. When configuring Lambda
     #   authorizers in the console, this is done for you. To use the Command
     #   Line Interface (CLI), run the following:
@@ -2355,7 +2623,9 @@ module Aws::AppSync
     end
 
     # @!attribute [rw] next_token
-    #   The API token.
+    #   An identifier that was returned from the previous call to this
+    #   operation, which you can use to return the next set of items in the
+    #   list.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -2376,7 +2646,9 @@ module Aws::AppSync
     #   @return [Array<Types::DomainNameConfig>]
     #
     # @!attribute [rw] next_token
-    #   The API token.
+    #   An identifier that was returned from the previous call to this
+    #   operation, which you can use to return the next set of items in the
+    #   list.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListDomainNamesResponse AWS API Documentation
@@ -2441,11 +2713,22 @@ module Aws::AppSync
     #   The maximum number of results that you want the request to return.
     #   @return [Integer]
     #
+    # @!attribute [rw] api_type
+    #   The value that indicates whether the GraphQL API is a standard API
+    #   (`GRAPHQL`) or merged API (`MERGED`).
+    #   @return [String]
+    #
+    # @!attribute [rw] owner
+    #   The account owner of the GraphQL API.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListGraphqlApisRequest AWS API Documentation
     #
     class ListGraphqlApisRequest < Struct.new(
       :next_token,
-      :max_results)
+      :max_results,
+      :api_type,
+      :owner)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2562,6 +2845,49 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # @!attribute [rw] api_id
+    #   The API ID.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   An identifier that was returned from the previous call to this
+    #   operation, which you can use to return the next set of items in the
+    #   list.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results that you want the request to return.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListSourceApiAssociationsRequest AWS API Documentation
+    #
+    class ListSourceApiAssociationsRequest < Struct.new(
+      :api_id,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] source_api_association_summaries
+    #   The `SourceApiAssociationSummary` object data.
+    #   @return [Array<Types::SourceApiAssociationSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   An identifier that was returned from the previous call to this
+    #   operation, which you can use to return the next set of items in the
+    #   list.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListSourceApiAssociationsResponse AWS API Documentation
+    #
+    class ListSourceApiAssociationsResponse < Struct.new(
+      :source_api_association_summaries,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] resource_arn
     #   The `GraphqlApi` Amazon Resource Name (ARN).
     #   @return [String]
@@ -2586,6 +2912,64 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # @!attribute [rw] merged_api_identifier
+    #   The identifier of the AppSync Merged API. This is generated by the
+    #   AppSync service. In most cases, Merged APIs (especially in your
+    #   account) only require the API ID value or ARN of the merged API.
+    #   However, Merged APIs in other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] association_id
+    #   The ID generated by the AppSync service for the source API
+    #   association.
+    #   @return [String]
+    #
+    # @!attribute [rw] format
+    #   The format type.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   An identifier that was returned from the previous call to this
+    #   operation, which you can use to return the next set of items in the
+    #   list.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results that you want the request to return.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListTypesByAssociationRequest AWS API Documentation
+    #
+    class ListTypesByAssociationRequest < Struct.new(
+      :merged_api_identifier,
+      :association_id,
+      :format,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] types
+    #   The `Type` objects.
+    #   @return [Array<Types::Type>]
+    #
+    # @!attribute [rw] next_token
+    #   An identifier that was returned from the previous call to this
+    #   operation, which you can use to return the next set of items in the
+    #   list.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListTypesByAssociationResponse AWS API Documentation
+    #
+    class ListTypesByAssociationResponse < Struct.new(
+      :types,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] api_id
     #   The API ID.
     #   @return [String]
@@ -2638,10 +3022,10 @@ module Aws::AppSync
     # @!attribute [rw] field_log_level
     #   The field logging level. Values can be NONE, ERROR, or ALL.
     #
-    #   * **NONE**\: No field-level logs are captured.
+    #   * **NONE**: No field-level logs are captured.
     #
-    #   * **ERROR**\: Logs the following information only for the fields
-    #     that are in error:
+    #   * **ERROR**: Logs the following information only for the fields that
+    #     are in error:
     #
     #     * The error section in the server response.
     #
@@ -2650,8 +3034,8 @@ module Aws::AppSync
     #     * The generated request/response functions that got resolved for
     #       error fields.
     #
-    #   * **ALL**\: The following information is logged for all fields in
-    #     the query:
+    #   * **ALL**: The following information is logged for all fields in the
+    #     query:
     #
     #     * Field-level tracing information.
     #
@@ -2804,8 +3188,8 @@ module Aws::AppSync
     # @!attribute [rw] relational_database_source_type
     #   Source type for the relational database.
     #
-    #   * **RDS\_HTTP\_ENDPOINT**\: The relational database source type is
-    #     an Amazon Relational Database Service (Amazon RDS) HTTP endpoint.
+    #   * **RDS\_HTTP\_ENDPOINT**: The relational database source type is an
+    #     Amazon Relational Database Service (Amazon RDS) HTTP endpoint.
     #
     #   ^
     #   @return [String]
@@ -2852,11 +3236,11 @@ module Aws::AppSync
     # @!attribute [rw] kind
     #   The resolver type.
     #
-    #   * **UNIT**\: A UNIT resolver type. A UNIT resolver is the default
+    #   * **UNIT**: A UNIT resolver type. A UNIT resolver is the default
     #     resolver type. You can use a UNIT resolver to run a GraphQL query
     #     against a single data source.
     #
-    #   * **PIPELINE**\: A PIPELINE resolver type. You can use a PIPELINE
+    #   * **PIPELINE**: A PIPELINE resolver type. You can use a PIPELINE
     #     resolver to invoke a series of `Function` objects in a serial
     #     manner. You can use a pipeline resolver to run a GraphQL query
     #     against multiple data sources.
@@ -2911,6 +3295,158 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # Describes the configuration of a source API. A source API is a GraphQL
+    # API that is linked to a merged API. There can be multiple source APIs
+    # attached to each merged API. When linked to a merged API, the source
+    # API's schema, data sources, and resolvers will be combined with other
+    # linked source API data to form a new, singular API.
+    #
+    # Source APIs can originate from your account or from other accounts via
+    # Amazon Web Services Resource Access Manager. For more information
+    # about sharing resources from other accounts, see [What is Amazon Web
+    # Services Resource Access Manager?][1] in the *Amazon Web Services
+    # Resource Access Manager* guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/ram/latest/userguide/what-is.html
+    #
+    # @!attribute [rw] association_id
+    #   The ID generated by the AppSync service for the source API
+    #   association.
+    #   @return [String]
+    #
+    # @!attribute [rw] association_arn
+    #   The Amazon Resource Name (ARN) of the source API association.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_id
+    #   The ID of the AppSync source API.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_arn
+    #   The Amazon Resource Name (ARN) of the AppSync source API.
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_arn
+    #   The Amazon Resource Name (ARN) of the AppSync Merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_id
+    #   The ID of the AppSync Merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description field.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_association_config
+    #   The `SourceApiAssociationConfig` object data.
+    #   @return [Types::SourceApiAssociationConfig]
+    #
+    # @!attribute [rw] source_api_association_status
+    #   The state of the source API association.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_association_status_detail
+    #   The detailed message related to the current state of the source API
+    #   association.
+    #   @return [String]
+    #
+    # @!attribute [rw] last_successful_merge_date
+    #   The datetime value of the last successful merge of the source API
+    #   association. The result will be in UTC format and your local time
+    #   zone.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/SourceApiAssociation AWS API Documentation
+    #
+    class SourceApiAssociation < Struct.new(
+      :association_id,
+      :association_arn,
+      :source_api_id,
+      :source_api_arn,
+      :merged_api_arn,
+      :merged_api_id,
+      :description,
+      :source_api_association_config,
+      :source_api_association_status,
+      :source_api_association_status_detail,
+      :last_successful_merge_date)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Describes properties used to specify configurations related to a
+    # source API.
+    #
+    # @!attribute [rw] merge_type
+    #   The property that indicates which merging option is enabled in the
+    #   source API association.
+    #
+    #   Valid merge types are `MANUAL_MERGE` (default) and `AUTO_MERGE`.
+    #   Manual merges are the default behavior and require the user to
+    #   trigger any changes from the source APIs to the merged API manually.
+    #   Auto merges subscribe the merged API to the changes performed on the
+    #   source APIs so that any change in the source APIs are also made to
+    #   the merged API. Auto merges use `MergedApiExecutionRoleArn` to
+    #   perform merge operations.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/SourceApiAssociationConfig AWS API Documentation
+    #
+    class SourceApiAssociationConfig < Struct.new(
+      :merge_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Describes the ARNs and IDs of associations, Merged APIs, and source
+    # APIs.
+    #
+    # @!attribute [rw] association_id
+    #   The ID generated by the AppSync service for the source API
+    #   association.
+    #   @return [String]
+    #
+    # @!attribute [rw] association_arn
+    #   The Amazon Resource Name (ARN) of the source API association.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_id
+    #   The ID of the AppSync source API.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_arn
+    #   The Amazon Resource Name (ARN) of the AppSync Source API.
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_id
+    #   The ID of the AppSync Merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_arn
+    #   The Amazon Resource Name (ARN) of the AppSync Merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description field.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/SourceApiAssociationSummary AWS API Documentation
+    #
+    class SourceApiAssociationSummary < Struct.new(
+      :association_id,
+      :association_arn,
+      :source_api_id,
+      :source_api_arn,
+      :merged_api_id,
+      :merged_api_arn,
+      :description)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] api_id
     #   The API ID.
     #   @return [String]
@@ -2942,6 +3478,40 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # @!attribute [rw] association_id
+    #   The ID generated by the AppSync service for the source API
+    #   association.
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_identifier
+    #   The identifier of the AppSync Merged API. This is generated by the
+    #   AppSync service. In most cases, Merged APIs (especially in your
+    #   account) only require the API ID value or ARN of the merged API.
+    #   However, Merged APIs in other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the merged API.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/StartSchemaMergeRequest AWS API Documentation
+    #
+    class StartSchemaMergeRequest < Struct.new(
+      :association_id,
+      :merged_api_identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] source_api_association_status
+    #   The state of the source API association.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/StartSchemaMergeResponse AWS API Documentation
+    #
+    class StartSchemaMergeResponse < Struct.new(
+      :source_api_association_status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes a Sync configuration for a resolver.
     #
     # Specifies which Conflict Detection strategy and Resolution strategy to
@@ -2951,24 +3521,24 @@ module Aws::AppSync
     #   The Conflict Resolution strategy to perform in the event of a
     #   conflict.
     #
-    #   * **OPTIMISTIC\_CONCURRENCY**\: Resolve conflicts by rejecting
+    #   * **OPTIMISTIC\_CONCURRENCY**: Resolve conflicts by rejecting
     #     mutations when versions don't match the latest version at the
     #     server.
     #
-    #   * **AUTOMERGE**\: Resolve conflicts with the Automerge conflict
+    #   * **AUTOMERGE**: Resolve conflicts with the Automerge conflict
     #     resolution strategy.
     #
-    #   * **LAMBDA**\: Resolve conflicts with an Lambda function supplied in
+    #   * **LAMBDA**: Resolve conflicts with an Lambda function supplied in
     #     the `LambdaConflictHandlerConfig`.
     #   @return [String]
     #
     # @!attribute [rw] conflict_detection
     #   The Conflict Detection strategy to use.
     #
-    #   * **VERSION**\: Detect conflicts based on object versions for this
+    #   * **VERSION**: Detect conflicts based on object versions for this
     #     resolver.
     #
-    #   * **NONE**\: Do not detect conflicts when invoking this resolver.
+    #   * **NONE**: Do not detect conflicts when invoking this resolver.
     #   @return [String]
     #
     # @!attribute [rw] lambda_conflict_handler_config
@@ -3090,9 +3660,9 @@ module Aws::AppSync
     # @!attribute [rw] api_caching_behavior
     #   Caching behavior.
     #
-    #   * **FULL\_REQUEST\_CACHING**\: All requests are fully cached.
+    #   * **FULL\_REQUEST\_CACHING**: All requests are fully cached.
     #
-    #   * **PER\_RESOLVER\_CACHING**\: Individual resolvers that you specify
+    #   * **PER\_RESOLVER\_CACHING**: Individual resolvers that you specify
     #     are cached.
     #   @return [String]
     #
@@ -3122,19 +3692,19 @@ module Aws::AppSync
     #   The following legacy instance types are available, but their use is
     #   discouraged:
     #
-    #   * **T2\_SMALL**\: A t2.small instance type.
+    #   * **T2\_SMALL**: A t2.small instance type.
     #
-    #   * **T2\_MEDIUM**\: A t2.medium instance type.
+    #   * **T2\_MEDIUM**: A t2.medium instance type.
     #
-    #   * **R4\_LARGE**\: A r4.large instance type.
+    #   * **R4\_LARGE**: A r4.large instance type.
     #
-    #   * **R4\_XLARGE**\: A r4.xlarge instance type.
+    #   * **R4\_XLARGE**: A r4.xlarge instance type.
     #
-    #   * **R4\_2XLARGE**\: A r4.2xlarge instance type.
+    #   * **R4\_2XLARGE**: A r4.2xlarge instance type.
     #
-    #   * **R4\_4XLARGE**\: A r4.4xlarge instance type.
+    #   * **R4\_4XLARGE**: A r4.4xlarge instance type.
     #
-    #   * **R4\_8XLARGE**\: A r4.8xlarge instance type.
+    #   * **R4\_8XLARGE**: A r4.8xlarge instance type.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/UpdateApiCacheRequest AWS API Documentation
@@ -3445,6 +4015,21 @@ module Aws::AppSync
     #   Configuration for Lambda function authorization.
     #   @return [Types::LambdaAuthorizerConfig]
     #
+    # @!attribute [rw] merged_api_execution_role_arn
+    #   The Identity and Access Management service role ARN for a merged
+    #   API. The AppSync service assumes this role on behalf of the Merged
+    #   API to validate access to source APIs at runtime and to prompt the
+    #   `AUTO_MERGE` to update the merged API endpoint with the source API
+    #   changes automatically.
+    #   @return [String]
+    #
+    # @!attribute [rw] owner_contact
+    #   The owner contact information for an API resource.
+    #
+    #   This field accepts any string input with a length of 0 - 256
+    #   characters.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/UpdateGraphqlApiRequest AWS API Documentation
     #
     class UpdateGraphqlApiRequest < Struct.new(
@@ -3456,7 +4041,9 @@ module Aws::AppSync
       :open_id_connect_config,
       :additional_authentication_providers,
       :xray_enabled,
-      :lambda_authorizer_config)
+      :lambda_authorizer_config,
+      :merged_api_execution_role_arn,
+      :owner_contact)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3508,11 +4095,11 @@ module Aws::AppSync
     # @!attribute [rw] kind
     #   The resolver type.
     #
-    #   * **UNIT**\: A UNIT resolver type. A UNIT resolver is the default
+    #   * **UNIT**: A UNIT resolver type. A UNIT resolver is the default
     #     resolver type. You can use a UNIT resolver to run a GraphQL query
     #     against a single data source.
     #
-    #   * **PIPELINE**\: A PIPELINE resolver type. You can use a PIPELINE
+    #   * **PIPELINE**: A PIPELINE resolver type. You can use a PIPELINE
     #     resolver to invoke a series of `Function` objects in a serial
     #     manner. You can use a pipeline resolver to run a GraphQL query
     #     against multiple data sources.
@@ -3579,6 +4166,50 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # @!attribute [rw] association_id
+    #   The ID generated by the AppSync service for the source API
+    #   association.
+    #   @return [String]
+    #
+    # @!attribute [rw] merged_api_identifier
+    #   The identifier of the AppSync Merged API. This is generated by the
+    #   AppSync service. In most cases, Merged APIs (especially in your
+    #   account) only require the API ID value or ARN of the merged API.
+    #   However, Merged APIs in other accounts (cross-account use cases)
+    #   strictly require the full resource ARN of the merged API.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description field.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_api_association_config
+    #   The `SourceApiAssociationConfig` object data.
+    #   @return [Types::SourceApiAssociationConfig]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/UpdateSourceApiAssociationRequest AWS API Documentation
+    #
+    class UpdateSourceApiAssociationRequest < Struct.new(
+      :association_id,
+      :merged_api_identifier,
+      :description,
+      :source_api_association_config)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] source_api_association
+    #   The `SourceApiAssociation` object data.
+    #   @return [Types::SourceApiAssociation]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/UpdateSourceApiAssociationResponse AWS API Documentation
+    #
+    class UpdateSourceApiAssociationResponse < Struct.new(
+      :source_api_association)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] api_id
     #   The API ID.
     #   @return [String]