aws-sdk-appsync 1.47.0 → 1.51.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -27,6 +27,8 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
31
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
30
32
  require 'aws-sdk-core/plugins/signature_v4.rb'
31
33
  require 'aws-sdk-core/plugins/protocols/rest_json.rb'
32
34
 
@@ -73,6 +75,8 @@ module Aws::AppSync
73
75
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
74
76
  add_plugin(Aws::Plugins::TransferEncoding)
75
77
  add_plugin(Aws::Plugins::HttpChecksum)
78
+ add_plugin(Aws::Plugins::DefaultsMode)
79
+ add_plugin(Aws::Plugins::RecursionDetection)
76
80
  add_plugin(Aws::Plugins::SignatureV4)
77
81
  add_plugin(Aws::Plugins::Protocols::RestJson)
78
82
 
@@ -175,6 +179,10 @@ module Aws::AppSync
175
179
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
176
180
  # a clock skew correction and retry requests with skewed client clocks.
177
181
  #
182
+ # @option options [String] :defaults_mode ("legacy")
183
+ # See {Aws::DefaultsModeConfiguration} for a list of the
184
+ # accepted modes and the configuration defaults that are included.
185
+ #
178
186
  # @option options [Boolean] :disable_host_prefix_injection (false)
179
187
  # Set to true to disable SDK automatically adding host prefix
180
188
  # to default service endpoint when available.
@@ -297,7 +305,7 @@ module Aws::AppSync
297
305
  # seconds to wait when opening a HTTP session before raising a
298
306
  # `Timeout::Error`.
299
307
  #
300
- # @option options [Integer] :http_read_timeout (60) The default
308
+ # @option options [Float] :http_read_timeout (60) The default
301
309
  # number of seconds to wait for response data. This value can
302
310
  # safely be set per-request on the session.
303
311
  #
@@ -313,6 +321,9 @@ module Aws::AppSync
313
321
  # disables this behaviour. This value can safely be set per
314
322
  # request on the session.
315
323
  #
324
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
325
+ # in seconds.
326
+ #
316
327
  # @option options [Boolean] :http_wire_trace (false) When `true`,
317
328
  # HTTP debug output will be sent to the `:logger`.
318
329
  #
@@ -338,22 +349,57 @@ module Aws::AppSync
338
349
 
339
350
  # @!group API Operations
340
351
 
352
+ # Maps an endpoint to your custom domain.
353
+ #
354
+ # @option params [required, String] :domain_name
355
+ # The domain name.
356
+ #
357
+ # @option params [required, String] :api_id
358
+ # The API ID.
359
+ #
360
+ # @return [Types::AssociateApiResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
361
+ #
362
+ # * {Types::AssociateApiResponse#api_association #api_association} => Types::ApiAssociation
363
+ #
364
+ # @example Request syntax with placeholder values
365
+ #
366
+ # resp = client.associate_api({
367
+ # domain_name: "DomainName", # required
368
+ # api_id: "String", # required
369
+ # })
370
+ #
371
+ # @example Response structure
372
+ #
373
+ # resp.api_association.domain_name #=> String
374
+ # resp.api_association.api_id #=> String
375
+ # resp.api_association.association_status #=> String, one of "PROCESSING", "FAILED", "SUCCESS"
376
+ # resp.api_association.deployment_detail #=> String
377
+ #
378
+ # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/AssociateApi AWS API Documentation
379
+ #
380
+ # @overload associate_api(params = {})
381
+ # @param [Hash] params ({})
382
+ def associate_api(params = {}, options = {})
383
+ req = build_request(:associate_api, params)
384
+ req.send_request(options)
385
+ end
386
+
341
387
  # Creates a cache for the GraphQL API.
342
388
  #
343
389
  # @option params [required, String] :api_id
344
- # The GraphQL API Id.
390
+ # The GraphQL API ID.
345
391
  #
346
392
  # @option params [required, Integer] :ttl
347
393
  # TTL in seconds for cache entries.
348
394
  #
349
- # Valid values are between 1 and 3600 seconds.
395
+ # Valid values are 1–3,600 seconds.
350
396
  #
351
397
  # @option params [Boolean] :transit_encryption_enabled
352
- # Transit encryption flag when connecting to cache. This setting cannot
353
- # be updated after creation.
398
+ # Transit encryption flag when connecting to cache. You cannot update
399
+ # this setting after creation.
354
400
  #
355
401
  # @option params [Boolean] :at_rest_encryption_enabled
356
- # At rest encryption flag for cache. This setting cannot be updated
402
+ # At-rest encryption flag for cache. You cannot update this setting
357
403
  # after creation.
358
404
  #
359
405
  # @option params [required, String] :api_caching_behavior
@@ -437,8 +483,8 @@ module Aws::AppSync
437
483
  req.send_request(options)
438
484
  end
439
485
 
440
- # Creates a unique key that you can distribute to clients who are
441
- # executing your API.
486
+ # Creates a unique key that you can distribute to clients who invoke
487
+ # your API.
442
488
  #
443
489
  # @option params [required, String] :api_id
444
490
  # The ID for your GraphQL API.
@@ -447,10 +493,10 @@ module Aws::AppSync
447
493
  # A description of the purpose of the API key.
448
494
  #
449
495
  # @option params [Integer] :expires
450
- # The time from creation time after which the API key expires. The date
451
- # is represented as seconds since the epoch, rounded down to the nearest
452
- # hour. The default value for this parameter is 7 days from creation
453
- # time. For more information, see .
496
+ # From the creation time, the time after which the API key expires. The
497
+ # date is represented as seconds since the epoch, rounded down to the
498
+ # nearest hour. The default value for this parameter is 7 days from
499
+ # creation time. For more information, see .
454
500
  #
455
501
  # @return [Types::CreateApiKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
456
502
  #
@@ -495,14 +541,15 @@ module Aws::AppSync
495
541
  # The type of the `DataSource`.
496
542
  #
497
543
  # @option params [String] :service_role_arn
498
- # The Identity and Access Management service role ARN for the data
499
- # source. The system assumes this role when accessing the data source.
544
+ # The Identity and Access Management (IAM) service role Amazon Resource
545
+ # Name (ARN) for the data source. The system assumes this role when
546
+ # accessing the data source.
500
547
  #
501
548
  # @option params [Types::DynamodbDataSourceConfig] :dynamodb_config
502
549
  # Amazon DynamoDB settings.
503
550
  #
504
551
  # @option params [Types::LambdaDataSourceConfig] :lambda_config
505
- # Amazon Web Services Lambda settings.
552
+ # Lambda settings.
506
553
  #
507
554
  # @option params [Types::ElasticsearchDataSourceConfig] :elasticsearch_config
508
555
  # Amazon OpenSearch Service settings.
@@ -616,9 +663,51 @@ module Aws::AppSync
616
663
  req.send_request(options)
617
664
  end
618
665
 
666
+ # Creates a custom `DomainName` object.
667
+ #
668
+ # @option params [required, String] :domain_name
669
+ # The domain name.
670
+ #
671
+ # @option params [required, String] :certificate_arn
672
+ # The Amazon Resource Name (ARN) of the certificate. This can be an
673
+ # Certificate Manager (ACM) certificate or an Identity and Access
674
+ # Management (IAM) server certificate.
675
+ #
676
+ # @option params [String] :description
677
+ # A description of the `DomainName`.
678
+ #
679
+ # @return [Types::CreateDomainNameResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
680
+ #
681
+ # * {Types::CreateDomainNameResponse#domain_name_config #domain_name_config} => Types::DomainNameConfig
682
+ #
683
+ # @example Request syntax with placeholder values
684
+ #
685
+ # resp = client.create_domain_name({
686
+ # domain_name: "DomainName", # required
687
+ # certificate_arn: "CertificateArn", # required
688
+ # description: "Description",
689
+ # })
690
+ #
691
+ # @example Response structure
692
+ #
693
+ # resp.domain_name_config.domain_name #=> String
694
+ # resp.domain_name_config.description #=> String
695
+ # resp.domain_name_config.certificate_arn #=> String
696
+ # resp.domain_name_config.appsync_domain_name #=> String
697
+ # resp.domain_name_config.hosted_zone_id #=> String
698
+ #
699
+ # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/CreateDomainName AWS API Documentation
700
+ #
701
+ # @overload create_domain_name(params = {})
702
+ # @param [Hash] params ({})
703
+ def create_domain_name(params = {}, options = {})
704
+ req = build_request(:create_domain_name, params)
705
+ req.send_request(options)
706
+ end
707
+
619
708
  # Creates a `Function` object.
620
709
  #
621
- # A function is a reusable entity. Multiple functions can be used to
710
+ # A function is a reusable entity. You can use multiple functions to
622
711
  # compose the resolver logic.
623
712
  #
624
713
  # @option params [required, String] :api_id
@@ -641,14 +730,17 @@ module Aws::AppSync
641
730
  # The `Function` response mapping template.
642
731
  #
643
732
  # @option params [required, String] :function_version
644
- # The `version` of the request mapping template. Currently the supported
645
- # value is 2018-05-29.
733
+ # The `version` of the request mapping template. Currently, the
734
+ # supported value is 2018-05-29.
646
735
  #
647
736
  # @option params [Types::SyncConfig] :sync_config
648
737
  # Describes a Sync configuration for a resolver.
649
738
  #
650
- # Contains information on which Conflict Detection as well as Resolution
651
- # strategy should be performed when the resolver is invoked.
739
+ # Specifies which Conflict Detection strategy and Resolution strategy to
740
+ # use when the resolver is invoked.
741
+ #
742
+ # @option params [Integer] :max_batch_size
743
+ # The maximum batching size for a resolver.
652
744
  #
653
745
  # @return [Types::CreateFunctionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
654
746
  #
@@ -671,6 +763,7 @@ module Aws::AppSync
671
763
  # lambda_conflict_handler_arn: "String",
672
764
  # },
673
765
  # },
766
+ # max_batch_size: 1,
674
767
  # })
675
768
  #
676
769
  # @example Response structure
@@ -686,6 +779,7 @@ module Aws::AppSync
686
779
  # resp.function_configuration.sync_config.conflict_handler #=> String, one of "OPTIMISTIC_CONCURRENCY", "LAMBDA", "AUTOMERGE", "NONE"
687
780
  # resp.function_configuration.sync_config.conflict_detection #=> String, one of "VERSION", "NONE"
688
781
  # resp.function_configuration.sync_config.lambda_conflict_handler_config.lambda_conflict_handler_arn #=> String
782
+ # resp.function_configuration.max_batch_size #=> Integer
689
783
  #
690
784
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/CreateFunction AWS API Documentation
691
785
  #
@@ -705,14 +799,14 @@ module Aws::AppSync
705
799
  # The Amazon CloudWatch Logs configuration.
706
800
  #
707
801
  # @option params [required, String] :authentication_type
708
- # The authentication type: API key, Identity and Access Management,
709
- # OIDC, Amazon Cognito user pools, or Amazon Web Services Lambda.
802
+ # The authentication type: API key, Identity and Access Management
803
+ # (IAM), OpenID Connect (OIDC), Amazon Cognito user pools, or Lambda.
710
804
  #
711
805
  # @option params [Types::UserPoolConfig] :user_pool_config
712
806
  # The Amazon Cognito user pool configuration.
713
807
  #
714
808
  # @option params [Types::OpenIDConnectConfig] :open_id_connect_config
715
- # The OpenID Connect configuration.
809
+ # The OIDC configuration.
716
810
  #
717
811
  # @option params [Hash<String,String>] :tags
718
812
  # A `TagMap` object.
@@ -722,11 +816,10 @@ module Aws::AppSync
722
816
  # API.
723
817
  #
724
818
  # @option params [Boolean] :xray_enabled
725
- # A flag indicating whether to enable X-Ray tracing for the
726
- # `GraphqlApi`.
819
+ # A flag indicating whether to use X-Ray tracing for the `GraphqlApi`.
727
820
  #
728
821
  # @option params [Types::LambdaAuthorizerConfig] :lambda_authorizer_config
729
- # Configuration for Amazon Web Services Lambda function authorization.
822
+ # Configuration for Lambda function authorization.
730
823
  #
731
824
  # @return [Types::CreateGraphqlApiResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
732
825
  #
@@ -837,7 +930,8 @@ module Aws::AppSync
837
930
  # Creates a `Resolver` object.
838
931
  #
839
932
  # A resolver converts incoming requests into a format that a data source
840
- # can understand and converts the data source's responses into GraphQL.
933
+ # can understand, and converts the data source's responses into
934
+ # GraphQL.
841
935
  #
842
936
  # @option params [required, String] :api_id
843
937
  # The ID for the GraphQL API for which the resolver is being created.
@@ -852,40 +946,43 @@ module Aws::AppSync
852
946
  # The name of the data source for which the resolver is being created.
853
947
  #
854
948
  # @option params [String] :request_mapping_template
855
- # The mapping template to be used for requests.
949
+ # The mapping template to use for requests.
856
950
  #
857
951
  # A resolver uses a request mapping template to convert a GraphQL
858
952
  # expression into a format that a data source can understand. Mapping
859
953
  # templates are written in Apache Velocity Template Language (VTL).
860
954
  #
861
- # VTL request mapping templates are optional when using a Lambda data
955
+ # VTL request mapping templates are optional when using an Lambda data
862
956
  # source. For all other data sources, VTL request and response mapping
863
957
  # templates are required.
864
958
  #
865
959
  # @option params [String] :response_mapping_template
866
- # The mapping template to be used for responses from the data source.
960
+ # The mapping template to use for responses from the data source.
867
961
  #
868
962
  # @option params [String] :kind
869
963
  # The resolver type.
870
964
  #
871
965
  # * **UNIT**\: A UNIT resolver type. A UNIT resolver is the default
872
- # resolver type. A UNIT resolver enables you to execute a GraphQL
873
- # query against a single data source.
966
+ # resolver type. You can use a UNIT resolver to run a GraphQL query
967
+ # against a single data source.
874
968
  #
875
- # * **PIPELINE**\: A PIPELINE resolver type. A PIPELINE resolver enables
876
- # you to execute a series of `Function` in a serial manner. You can
877
- # use a pipeline resolver to execute a GraphQL query against multiple
878
- # data sources.
969
+ # * **PIPELINE**\: A PIPELINE resolver type. You can use a PIPELINE
970
+ # resolver to invoke a series of `Function` objects in a serial
971
+ # manner. You can use a pipeline resolver to run a GraphQL query
972
+ # against multiple data sources.
879
973
  #
880
974
  # @option params [Types::PipelineConfig] :pipeline_config
881
975
  # The `PipelineConfig`.
882
976
  #
883
977
  # @option params [Types::SyncConfig] :sync_config
884
- # The `SyncConfig` for a resolver attached to a versioned datasource.
978
+ # The `SyncConfig` for a resolver attached to a versioned data source.
885
979
  #
886
980
  # @option params [Types::CachingConfig] :caching_config
887
981
  # The caching configuration for the resolver.
888
982
  #
983
+ # @option params [Integer] :max_batch_size
984
+ # The maximum batching size for a resolver.
985
+ #
889
986
  # @return [Types::CreateResolverResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
890
987
  #
891
988
  # * {Types::CreateResolverResponse#resolver #resolver} => Types::Resolver
@@ -914,6 +1011,7 @@ module Aws::AppSync
914
1011
  # ttl: 1,
915
1012
  # caching_keys: ["String"],
916
1013
  # },
1014
+ # max_batch_size: 1,
917
1015
  # })
918
1016
  #
919
1017
  # @example Response structure
@@ -933,6 +1031,7 @@ module Aws::AppSync
933
1031
  # resp.resolver.caching_config.ttl #=> Integer
934
1032
  # resp.resolver.caching_config.caching_keys #=> Array
935
1033
  # resp.resolver.caching_config.caching_keys[0] #=> String
1034
+ # resp.resolver.max_batch_size #=> Integer
936
1035
  #
937
1036
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/CreateResolver AWS API Documentation
938
1037
  #
@@ -1064,6 +1163,28 @@ module Aws::AppSync
1064
1163
  req.send_request(options)
1065
1164
  end
1066
1165
 
1166
+ # Deletes a custom `DomainName` object.
1167
+ #
1168
+ # @option params [required, String] :domain_name
1169
+ # The domain name.
1170
+ #
1171
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1172
+ #
1173
+ # @example Request syntax with placeholder values
1174
+ #
1175
+ # resp = client.delete_domain_name({
1176
+ # domain_name: "DomainName", # required
1177
+ # })
1178
+ #
1179
+ # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/DeleteDomainName AWS API Documentation
1180
+ #
1181
+ # @overload delete_domain_name(params = {})
1182
+ # @param [Hash] params ({})
1183
+ def delete_domain_name(params = {}, options = {})
1184
+ req = build_request(:delete_domain_name, params)
1185
+ req.send_request(options)
1186
+ end
1187
+
1067
1188
  # Deletes a `Function`.
1068
1189
  #
1069
1190
  # @option params [required, String] :api_id
@@ -1168,6 +1289,28 @@ module Aws::AppSync
1168
1289
  req.send_request(options)
1169
1290
  end
1170
1291
 
1292
+ # Removes an `ApiAssociation` object from a custom domain.
1293
+ #
1294
+ # @option params [required, String] :domain_name
1295
+ # The domain name.
1296
+ #
1297
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1298
+ #
1299
+ # @example Request syntax with placeholder values
1300
+ #
1301
+ # resp = client.disassociate_api({
1302
+ # domain_name: "DomainName", # required
1303
+ # })
1304
+ #
1305
+ # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/DisassociateApi AWS API Documentation
1306
+ #
1307
+ # @overload disassociate_api(params = {})
1308
+ # @param [Hash] params ({})
1309
+ def disassociate_api(params = {}, options = {})
1310
+ req = build_request(:disassociate_api, params)
1311
+ req.send_request(options)
1312
+ end
1313
+
1171
1314
  # Flushes an `ApiCache` object.
1172
1315
  #
1173
1316
  # @option params [required, String] :api_id
@@ -1190,6 +1333,37 @@ module Aws::AppSync
1190
1333
  req.send_request(options)
1191
1334
  end
1192
1335
 
1336
+ # Retrieves an `ApiAssociation` object.
1337
+ #
1338
+ # @option params [required, String] :domain_name
1339
+ # The domain name.
1340
+ #
1341
+ # @return [Types::GetApiAssociationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1342
+ #
1343
+ # * {Types::GetApiAssociationResponse#api_association #api_association} => Types::ApiAssociation
1344
+ #
1345
+ # @example Request syntax with placeholder values
1346
+ #
1347
+ # resp = client.get_api_association({
1348
+ # domain_name: "DomainName", # required
1349
+ # })
1350
+ #
1351
+ # @example Response structure
1352
+ #
1353
+ # resp.api_association.domain_name #=> String
1354
+ # resp.api_association.api_id #=> String
1355
+ # resp.api_association.association_status #=> String, one of "PROCESSING", "FAILED", "SUCCESS"
1356
+ # resp.api_association.deployment_detail #=> String
1357
+ #
1358
+ # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetApiAssociation AWS API Documentation
1359
+ #
1360
+ # @overload get_api_association(params = {})
1361
+ # @param [Hash] params ({})
1362
+ def get_api_association(params = {}, options = {})
1363
+ req = build_request(:get_api_association, params)
1364
+ req.send_request(options)
1365
+ end
1366
+
1193
1367
  # Retrieves an `ApiCache` object.
1194
1368
  #
1195
1369
  # @option params [required, String] :api_id
@@ -1281,6 +1455,38 @@ module Aws::AppSync
1281
1455
  req.send_request(options)
1282
1456
  end
1283
1457
 
1458
+ # Retrieves a custom `DomainName` object.
1459
+ #
1460
+ # @option params [required, String] :domain_name
1461
+ # The domain name.
1462
+ #
1463
+ # @return [Types::GetDomainNameResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1464
+ #
1465
+ # * {Types::GetDomainNameResponse#domain_name_config #domain_name_config} => Types::DomainNameConfig
1466
+ #
1467
+ # @example Request syntax with placeholder values
1468
+ #
1469
+ # resp = client.get_domain_name({
1470
+ # domain_name: "DomainName", # required
1471
+ # })
1472
+ #
1473
+ # @example Response structure
1474
+ #
1475
+ # resp.domain_name_config.domain_name #=> String
1476
+ # resp.domain_name_config.description #=> String
1477
+ # resp.domain_name_config.certificate_arn #=> String
1478
+ # resp.domain_name_config.appsync_domain_name #=> String
1479
+ # resp.domain_name_config.hosted_zone_id #=> String
1480
+ #
1481
+ # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetDomainName AWS API Documentation
1482
+ #
1483
+ # @overload get_domain_name(params = {})
1484
+ # @param [Hash] params ({})
1485
+ def get_domain_name(params = {}, options = {})
1486
+ req = build_request(:get_domain_name, params)
1487
+ req.send_request(options)
1488
+ end
1489
+
1284
1490
  # Get a `Function`.
1285
1491
  #
1286
1492
  # @option params [required, String] :api_id
@@ -1313,6 +1519,7 @@ module Aws::AppSync
1313
1519
  # resp.function_configuration.sync_config.conflict_handler #=> String, one of "OPTIMISTIC_CONCURRENCY", "LAMBDA", "AUTOMERGE", "NONE"
1314
1520
  # resp.function_configuration.sync_config.conflict_detection #=> String, one of "VERSION", "NONE"
1315
1521
  # resp.function_configuration.sync_config.lambda_conflict_handler_config.lambda_conflict_handler_arn #=> String
1522
+ # resp.function_configuration.max_batch_size #=> Integer
1316
1523
  #
1317
1524
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetFunction AWS API Documentation
1318
1525
  #
@@ -1463,6 +1670,7 @@ module Aws::AppSync
1463
1670
  # resp.resolver.caching_config.ttl #=> Integer
1464
1671
  # resp.resolver.caching_config.caching_keys #=> Array
1465
1672
  # resp.resolver.caching_config.caching_keys[0] #=> String
1673
+ # resp.resolver.max_batch_size #=> Integer
1466
1674
  #
1467
1675
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetResolver AWS API Documentation
1468
1676
  #
@@ -1557,11 +1765,11 @@ module Aws::AppSync
1557
1765
  #
1558
1766
  # @option params [String] :next_token
1559
1767
  # An identifier that was returned from the previous call to this
1560
- # operation, which can be used to return the next set of items in the
1768
+ # operation, which you can use to return the next set of items in the
1561
1769
  # list.
1562
1770
  #
1563
1771
  # @option params [Integer] :max_results
1564
- # The maximum number of results you want the request to return.
1772
+ # The maximum number of results that you want the request to return.
1565
1773
  #
1566
1774
  # @return [Types::ListApiKeysResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1567
1775
  #
@@ -1601,11 +1809,11 @@ module Aws::AppSync
1601
1809
  #
1602
1810
  # @option params [String] :next_token
1603
1811
  # An identifier that was returned from the previous call to this
1604
- # operation, which can be used to return the next set of items in the
1812
+ # operation, which you can use to return the next set of items in the
1605
1813
  # list.
1606
1814
  #
1607
1815
  # @option params [Integer] :max_results
1608
- # The maximum number of results you want the request to return.
1816
+ # The maximum number of results that you want the request to return.
1609
1817
  #
1610
1818
  # @return [Types::ListDataSourcesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1611
1819
  #
@@ -1661,6 +1869,45 @@ module Aws::AppSync
1661
1869
  req.send_request(options)
1662
1870
  end
1663
1871
 
1872
+ # Lists multiple custom domain names.
1873
+ #
1874
+ # @option params [String] :next_token
1875
+ # The API token.
1876
+ #
1877
+ # @option params [Integer] :max_results
1878
+ # The maximum number of results that you want the request to return.
1879
+ #
1880
+ # @return [Types::ListDomainNamesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1881
+ #
1882
+ # * {Types::ListDomainNamesResponse#domain_name_configs #domain_name_configs} => Array&lt;Types::DomainNameConfig&gt;
1883
+ # * {Types::ListDomainNamesResponse#next_token #next_token} => String
1884
+ #
1885
+ # @example Request syntax with placeholder values
1886
+ #
1887
+ # resp = client.list_domain_names({
1888
+ # next_token: "PaginationToken",
1889
+ # max_results: 1,
1890
+ # })
1891
+ #
1892
+ # @example Response structure
1893
+ #
1894
+ # resp.domain_name_configs #=> Array
1895
+ # resp.domain_name_configs[0].domain_name #=> String
1896
+ # resp.domain_name_configs[0].description #=> String
1897
+ # resp.domain_name_configs[0].certificate_arn #=> String
1898
+ # resp.domain_name_configs[0].appsync_domain_name #=> String
1899
+ # resp.domain_name_configs[0].hosted_zone_id #=> String
1900
+ # resp.next_token #=> String
1901
+ #
1902
+ # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListDomainNames AWS API Documentation
1903
+ #
1904
+ # @overload list_domain_names(params = {})
1905
+ # @param [Hash] params ({})
1906
+ def list_domain_names(params = {}, options = {})
1907
+ req = build_request(:list_domain_names, params)
1908
+ req.send_request(options)
1909
+ end
1910
+
1664
1911
  # List multiple functions.
1665
1912
  #
1666
1913
  # @option params [required, String] :api_id
@@ -1668,11 +1915,11 @@ module Aws::AppSync
1668
1915
  #
1669
1916
  # @option params [String] :next_token
1670
1917
  # An identifier that was returned from the previous call to this
1671
- # operation, which can be used to return the next set of items in the
1918
+ # operation, which you can use to return the next set of items in the
1672
1919
  # list.
1673
1920
  #
1674
1921
  # @option params [Integer] :max_results
1675
- # The maximum number of results you want the request to return.
1922
+ # The maximum number of results that you want the request to return.
1676
1923
  #
1677
1924
  # @return [Types::ListFunctionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1678
1925
  #
@@ -1701,6 +1948,7 @@ module Aws::AppSync
1701
1948
  # resp.functions[0].sync_config.conflict_handler #=> String, one of "OPTIMISTIC_CONCURRENCY", "LAMBDA", "AUTOMERGE", "NONE"
1702
1949
  # resp.functions[0].sync_config.conflict_detection #=> String, one of "VERSION", "NONE"
1703
1950
  # resp.functions[0].sync_config.lambda_conflict_handler_config.lambda_conflict_handler_arn #=> String
1951
+ # resp.functions[0].max_batch_size #=> Integer
1704
1952
  # resp.next_token #=> String
1705
1953
  #
1706
1954
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListFunctions AWS API Documentation
@@ -1716,11 +1964,11 @@ module Aws::AppSync
1716
1964
  #
1717
1965
  # @option params [String] :next_token
1718
1966
  # An identifier that was returned from the previous call to this
1719
- # operation, which can be used to return the next set of items in the
1967
+ # operation, which you can use to return the next set of items in the
1720
1968
  # list.
1721
1969
  #
1722
1970
  # @option params [Integer] :max_results
1723
- # The maximum number of results you want the request to return.
1971
+ # The maximum number of results that you want the request to return.
1724
1972
  #
1725
1973
  # @return [Types::ListGraphqlApisResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1726
1974
  #
@@ -1794,11 +2042,11 @@ module Aws::AppSync
1794
2042
  #
1795
2043
  # @option params [String] :next_token
1796
2044
  # An identifier that was returned from the previous call to this
1797
- # operation, which can be used to return the next set of items in the
2045
+ # operation, which you can use to return the next set of items in the
1798
2046
  # list.
1799
2047
  #
1800
2048
  # @option params [Integer] :max_results
1801
- # The maximum number of results you want the request to return.
2049
+ # The maximum number of results that you want the request to return.
1802
2050
  #
1803
2051
  # @return [Types::ListResolversResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1804
2052
  #
@@ -1832,6 +2080,7 @@ module Aws::AppSync
1832
2080
  # resp.resolvers[0].caching_config.ttl #=> Integer
1833
2081
  # resp.resolvers[0].caching_config.caching_keys #=> Array
1834
2082
  # resp.resolvers[0].caching_config.caching_keys[0] #=> String
2083
+ # resp.resolvers[0].max_batch_size #=> Integer
1835
2084
  # resp.next_token #=> String
1836
2085
  #
1837
2086
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListResolvers AWS API Documentation
@@ -1849,7 +2098,7 @@ module Aws::AppSync
1849
2098
  # The API ID.
1850
2099
  #
1851
2100
  # @option params [required, String] :function_id
1852
- # The Function ID.
2101
+ # The function ID.
1853
2102
  #
1854
2103
  # @option params [String] :next_token
1855
2104
  # An identifier that was returned from the previous call to this
@@ -1857,7 +2106,7 @@ module Aws::AppSync
1857
2106
  # list.
1858
2107
  #
1859
2108
  # @option params [Integer] :max_results
1860
- # The maximum number of results you want the request to return.
2109
+ # The maximum number of results that you want the request to return.
1861
2110
  #
1862
2111
  # @return [Types::ListResolversByFunctionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1863
2112
  #
@@ -1891,6 +2140,7 @@ module Aws::AppSync
1891
2140
  # resp.resolvers[0].caching_config.ttl #=> Integer
1892
2141
  # resp.resolvers[0].caching_config.caching_keys #=> Array
1893
2142
  # resp.resolvers[0].caching_config.caching_keys[0] #=> String
2143
+ # resp.resolvers[0].max_batch_size #=> Integer
1894
2144
  # resp.next_token #=> String
1895
2145
  #
1896
2146
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/ListResolversByFunction AWS API Documentation
@@ -1905,7 +2155,7 @@ module Aws::AppSync
1905
2155
  # Lists the tags for a resource.
1906
2156
  #
1907
2157
  # @option params [required, String] :resource_arn
1908
- # The `GraphqlApi` ARN.
2158
+ # The `GraphqlApi` Amazon Resource Name (ARN).
1909
2159
  #
1910
2160
  # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1911
2161
  #
@@ -1941,11 +2191,11 @@ module Aws::AppSync
1941
2191
  #
1942
2192
  # @option params [String] :next_token
1943
2193
  # An identifier that was returned from the previous call to this
1944
- # operation, which can be used to return the next set of items in the
2194
+ # operation, which you can use to return the next set of items in the
1945
2195
  # list.
1946
2196
  #
1947
2197
  # @option params [Integer] :max_results
1948
- # The maximum number of results you want the request to return.
2198
+ # The maximum number of results that you want the request to return.
1949
2199
  #
1950
2200
  # @return [Types::ListTypesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1951
2201
  #
@@ -2018,7 +2268,7 @@ module Aws::AppSync
2018
2268
  # Tags a resource with user-supplied tags.
2019
2269
  #
2020
2270
  # @option params [required, String] :resource_arn
2021
- # The `GraphqlApi` ARN.
2271
+ # The `GraphqlApi` Amazon Resource Name (ARN).
2022
2272
  #
2023
2273
  # @option params [required, Hash<String,String>] :tags
2024
2274
  # A `TagMap` object.
@@ -2046,7 +2296,7 @@ module Aws::AppSync
2046
2296
  # Untags a resource.
2047
2297
  #
2048
2298
  # @option params [required, String] :resource_arn
2049
- # The `GraphqlApi` ARN.
2299
+ # The `GraphqlApi` Amazon Resource Name (ARN).
2050
2300
  #
2051
2301
  # @option params [required, Array<String>] :tag_keys
2052
2302
  # A list of `TagKey` objects.
@@ -2072,12 +2322,12 @@ module Aws::AppSync
2072
2322
  # Updates the cache for the GraphQL API.
2073
2323
  #
2074
2324
  # @option params [required, String] :api_id
2075
- # The GraphQL API Id.
2325
+ # The GraphQL API ID.
2076
2326
  #
2077
2327
  # @option params [required, Integer] :ttl
2078
2328
  # TTL in seconds for cache entries.
2079
2329
  #
2080
- # Valid values are between 1 and 3600 seconds.
2330
+ # Valid values are 1–3,600 seconds.
2081
2331
  #
2082
2332
  # @option params [required, String] :api_caching_behavior
2083
2333
  # Caching behavior.
@@ -2158,7 +2408,8 @@ module Aws::AppSync
2158
2408
  req.send_request(options)
2159
2409
  end
2160
2410
 
2161
- # Updates an API key. The key can be updated while it is not deleted.
2411
+ # Updates an API key. You can update the key as long as it's not
2412
+ # deleted.
2162
2413
  #
2163
2414
  # @option params [required, String] :api_id
2164
2415
  # The ID for the GraphQL API.
@@ -2170,8 +2421,9 @@ module Aws::AppSync
2170
2421
  # A description of the purpose of the API key.
2171
2422
  #
2172
2423
  # @option params [Integer] :expires
2173
- # The time from update time after which the API key expires. The date is
2174
- # represented as seconds since the epoch. For more information, see .
2424
+ # From the update time, the time after which the API key expires. The
2425
+ # date is represented as seconds since the epoch. For more information,
2426
+ # see .
2175
2427
  #
2176
2428
  # @return [Types::UpdateApiKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2177
2429
  #
@@ -2217,13 +2469,13 @@ module Aws::AppSync
2217
2469
  # The new data source type.
2218
2470
  #
2219
2471
  # @option params [String] :service_role_arn
2220
- # The new service role ARN for the data source.
2472
+ # The new service role Amazon Resource Name (ARN) for the data source.
2221
2473
  #
2222
2474
  # @option params [Types::DynamodbDataSourceConfig] :dynamodb_config
2223
2475
  # The new Amazon DynamoDB configuration.
2224
2476
  #
2225
2477
  # @option params [Types::LambdaDataSourceConfig] :lambda_config
2226
- # The new Amazon Web Services Lambda configuration.
2478
+ # The new Lambda configuration.
2227
2479
  #
2228
2480
  # @option params [Types::ElasticsearchDataSourceConfig] :elasticsearch_config
2229
2481
  # The new OpenSearch configuration.
@@ -2337,6 +2589,42 @@ module Aws::AppSync
2337
2589
  req.send_request(options)
2338
2590
  end
2339
2591
 
2592
+ # Updates a custom `DomainName` object.
2593
+ #
2594
+ # @option params [required, String] :domain_name
2595
+ # The domain name.
2596
+ #
2597
+ # @option params [String] :description
2598
+ # A description of the `DomainName`.
2599
+ #
2600
+ # @return [Types::UpdateDomainNameResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2601
+ #
2602
+ # * {Types::UpdateDomainNameResponse#domain_name_config #domain_name_config} => Types::DomainNameConfig
2603
+ #
2604
+ # @example Request syntax with placeholder values
2605
+ #
2606
+ # resp = client.update_domain_name({
2607
+ # domain_name: "DomainName", # required
2608
+ # description: "Description",
2609
+ # })
2610
+ #
2611
+ # @example Response structure
2612
+ #
2613
+ # resp.domain_name_config.domain_name #=> String
2614
+ # resp.domain_name_config.description #=> String
2615
+ # resp.domain_name_config.certificate_arn #=> String
2616
+ # resp.domain_name_config.appsync_domain_name #=> String
2617
+ # resp.domain_name_config.hosted_zone_id #=> String
2618
+ #
2619
+ # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/UpdateDomainName AWS API Documentation
2620
+ #
2621
+ # @overload update_domain_name(params = {})
2622
+ # @param [Hash] params ({})
2623
+ def update_domain_name(params = {}, options = {})
2624
+ req = build_request(:update_domain_name, params)
2625
+ req.send_request(options)
2626
+ end
2627
+
2340
2628
  # Updates a `Function` object.
2341
2629
  #
2342
2630
  # @option params [required, String] :api_id
@@ -2362,14 +2650,17 @@ module Aws::AppSync
2362
2650
  # The `Function` request mapping template.
2363
2651
  #
2364
2652
  # @option params [required, String] :function_version
2365
- # The `version` of the request mapping template. Currently the supported
2366
- # value is 2018-05-29.
2653
+ # The `version` of the request mapping template. Currently, the
2654
+ # supported value is 2018-05-29.
2367
2655
  #
2368
2656
  # @option params [Types::SyncConfig] :sync_config
2369
2657
  # Describes a Sync configuration for a resolver.
2370
2658
  #
2371
- # Contains information on which Conflict Detection as well as Resolution
2372
- # strategy should be performed when the resolver is invoked.
2659
+ # Specifies which Conflict Detection strategy and Resolution strategy to
2660
+ # use when the resolver is invoked.
2661
+ #
2662
+ # @option params [Integer] :max_batch_size
2663
+ # The maximum batching size for a resolver.
2373
2664
  #
2374
2665
  # @return [Types::UpdateFunctionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2375
2666
  #
@@ -2393,6 +2684,7 @@ module Aws::AppSync
2393
2684
  # lambda_conflict_handler_arn: "String",
2394
2685
  # },
2395
2686
  # },
2687
+ # max_batch_size: 1,
2396
2688
  # })
2397
2689
  #
2398
2690
  # @example Response structure
@@ -2408,6 +2700,7 @@ module Aws::AppSync
2408
2700
  # resp.function_configuration.sync_config.conflict_handler #=> String, one of "OPTIMISTIC_CONCURRENCY", "LAMBDA", "AUTOMERGE", "NONE"
2409
2701
  # resp.function_configuration.sync_config.conflict_detection #=> String, one of "VERSION", "NONE"
2410
2702
  # resp.function_configuration.sync_config.lambda_conflict_handler_config.lambda_conflict_handler_arn #=> String
2703
+ # resp.function_configuration.max_batch_size #=> Integer
2411
2704
  #
2412
2705
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/UpdateFunction AWS API Documentation
2413
2706
  #
@@ -2433,7 +2726,7 @@ module Aws::AppSync
2433
2726
  # The new authentication type for the `GraphqlApi` object.
2434
2727
  #
2435
2728
  # @option params [Types::UserPoolConfig] :user_pool_config
2436
- # The new Amazon Cognito user pool configuration for the `GraphqlApi`
2729
+ # The new Amazon Cognito user pool configuration for the `~GraphqlApi`
2437
2730
  # object.
2438
2731
  #
2439
2732
  # @option params [Types::OpenIDConnectConfig] :open_id_connect_config
@@ -2444,11 +2737,10 @@ module Aws::AppSync
2444
2737
  # API.
2445
2738
  #
2446
2739
  # @option params [Boolean] :xray_enabled
2447
- # A flag indicating whether to enable X-Ray tracing for the
2448
- # `GraphqlApi`.
2740
+ # A flag indicating whether to use X-Ray tracing for the `GraphqlApi`.
2449
2741
  #
2450
2742
  # @option params [Types::LambdaAuthorizerConfig] :lambda_authorizer_config
2451
- # Configuration for Amazon Web Services Lambda function authorization.
2743
+ # Configuration for Lambda function authorization.
2452
2744
  #
2453
2745
  # @return [Types::UpdateGraphqlApiResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2454
2746
  #
@@ -2575,7 +2867,7 @@ module Aws::AppSync
2575
2867
  # expression into a format that a data source can understand. Mapping
2576
2868
  # templates are written in Apache Velocity Template Language (VTL).
2577
2869
  #
2578
- # VTL request mapping templates are optional when using a Lambda data
2870
+ # VTL request mapping templates are optional when using an Lambda data
2579
2871
  # source. For all other data sources, VTL request and response mapping
2580
2872
  # templates are required.
2581
2873
  #
@@ -2586,23 +2878,26 @@ module Aws::AppSync
2586
2878
  # The resolver type.
2587
2879
  #
2588
2880
  # * **UNIT**\: A UNIT resolver type. A UNIT resolver is the default
2589
- # resolver type. A UNIT resolver enables you to execute a GraphQL
2590
- # query against a single data source.
2881
+ # resolver type. You can use a UNIT resolver to run a GraphQL query
2882
+ # against a single data source.
2591
2883
  #
2592
- # * **PIPELINE**\: A PIPELINE resolver type. A PIPELINE resolver enables
2593
- # you to execute a series of `Function` in a serial manner. You can
2594
- # use a pipeline resolver to execute a GraphQL query against multiple
2595
- # data sources.
2884
+ # * **PIPELINE**\: A PIPELINE resolver type. You can use a PIPELINE
2885
+ # resolver to invoke a series of `Function` objects in a serial
2886
+ # manner. You can use a pipeline resolver to run a GraphQL query
2887
+ # against multiple data sources.
2596
2888
  #
2597
2889
  # @option params [Types::PipelineConfig] :pipeline_config
2598
2890
  # The `PipelineConfig`.
2599
2891
  #
2600
2892
  # @option params [Types::SyncConfig] :sync_config
2601
- # The `SyncConfig` for a resolver attached to a versioned datasource.
2893
+ # The `SyncConfig` for a resolver attached to a versioned data source.
2602
2894
  #
2603
2895
  # @option params [Types::CachingConfig] :caching_config
2604
2896
  # The caching configuration for the resolver.
2605
2897
  #
2898
+ # @option params [Integer] :max_batch_size
2899
+ # The maximum batching size for a resolver.
2900
+ #
2606
2901
  # @return [Types::UpdateResolverResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2607
2902
  #
2608
2903
  # * {Types::UpdateResolverResponse#resolver #resolver} => Types::Resolver
@@ -2631,6 +2926,7 @@ module Aws::AppSync
2631
2926
  # ttl: 1,
2632
2927
  # caching_keys: ["String"],
2633
2928
  # },
2929
+ # max_batch_size: 1,
2634
2930
  # })
2635
2931
  #
2636
2932
  # @example Response structure
@@ -2650,6 +2946,7 @@ module Aws::AppSync
2650
2946
  # resp.resolver.caching_config.ttl #=> Integer
2651
2947
  # resp.resolver.caching_config.caching_keys #=> Array
2652
2948
  # resp.resolver.caching_config.caching_keys[0] #=> String
2949
+ # resp.resolver.max_batch_size #=> Integer
2653
2950
  #
2654
2951
  # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/UpdateResolver AWS API Documentation
2655
2952
  #
@@ -2717,7 +3014,7 @@ module Aws::AppSync
2717
3014
  params: params,
2718
3015
  config: config)
2719
3016
  context[:gem_name] = 'aws-sdk-appsync'
2720
- context[:gem_version] = '1.47.0'
3017
+ context[:gem_version] = '1.51.0'
2721
3018
  Seahorse::Client::Request.new(handlers, context)
2722
3019
  end
2723
3020