aws-sdk-appsync 1.47.0 → 1.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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