aws-sdk-apprunner 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7d47944c896a004b3aa87b26d20fc540481ffef169d718fb13048820ac864f7
-  data.tar.gz: ba61d463501bb3d7a5a80994ac08b30528aea1ad65037ce489b62b90e1a2b57b
+  metadata.gz: 7544607356ba39d2934eadd30c088bb36d0de00cc03e96c3b602559b25928232
+  data.tar.gz: 8030ee818bee71a4fedde8477a4d11fd52492d4eddbe146890a95ab22ccef612
 SHA512:
-  metadata.gz: 103bbf21ae7c07c60a4e3e22c663600e361e3ad499431a2718df75e9307bec4785816a9f1f254341bc597feaa2e40c267ceddec0b2195ac1f3596a11e6b4c717
-  data.tar.gz: 6708e0dba70973658dd6a8e81281bd31f6b8e95315e436e20db850ecd6e5d7c0195e3f80e529467a9bbd1b6c5da635c94eed2e7c5d2065d0e2537450a06f6e8a
+  metadata.gz: 35acd78629f357a88491ec910732728b0e1c77f3a93d649a48e4789475b043200a5d4127d4fae77af3c13f3d6f7dfde29f37f439fdcfd77caf322d741317f8de
+  data.tar.gz: b0a99c5d7b65e464125f33773e4b9673ef5c2fb0c860bea489a4f30b44ee0e2c253a22c8d6e6aaad7b2b9533c8eaf65764511ed704436774763c6ac591b07db7

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.10.0 (2022-02-08)
+------------------
+
+* Feature - This release adds support for App Runner to route outbound network traffic of a service through an Amazon VPC. New API: CreateVpcConnector, DescribeVpcConnector, ListVpcConnectors, and DeleteVpcConnector. Updated API: CreateService, DescribeService, and UpdateService.
+
 1.9.0 (2022-02-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.9.0
+1.10.0

data/lib/aws-sdk-apprunner/client.rb

@@ -432,11 +432,11 @@ module Aws::AppRunner
     # require non-default auto scaling settings. You can share an auto
     # scaling configuration across multiple services.
     #
-    # Create multiple revisions of a configuration by using the same
-    # `AutoScalingConfigurationName` and different
-    # `AutoScalingConfigurationRevision` values. When you create a service,
-    # you can set it to use the latest active revision of an auto scaling
-    # configuration or a specific revision.
+    # Create multiple revisions of a configuration by calling this action
+    # multiple times using the same `AutoScalingConfigurationName`. The call
+    # returns incremental `AutoScalingConfigurationRevision` values. When
+    # you create a service, you can set it to use the latest active revision
+    # of an auto scaling configuration or a specific revision.
     #
     # Configure a higher `MinSize` to increase the spread of your App Runner
     # service over more Availability Zones in the Amazon Web Services
@@ -452,6 +452,17 @@ module Aws::AppRunner
     #   subsequent calls, App Runner creates incremental revisions of the
     #   configuration.
     #
+    #   <note markdown="1"> The name `DefaultConfiguration` is reserved (it's the configuration
+    #   that App Runner uses if you don't provide a custome one). You can't
+    #   use it to create a new auto scaling configuration, and you can't
+    #   create a revision of it.
+    #
+    #    When you want to use your own auto scaling configuration for your App
+    #   Runner service, *create a configuration with a different name*, and
+    #   then provide it when you create or update your service.
+    #
+    #    </note>
+    #
     # @option params [Integer] :max_concurrency
     #   The maximum number of concurrent requests that you want an instance to
     #   process. If the number of concurrent requests exceeds this limit, App
@@ -592,9 +603,9 @@ module Aws::AppRunner
     # [1]: https://docs.aws.amazon.com/apprunner/latest/api/API_ListOperations.html
     #
     # @option params [required, String] :service_name
-    #   A name for the new service. It must be unique across all the running
-    #   App Runner services in your Amazon Web Services account in the Amazon
-    #   Web Services Region.
+    #   A name for the App Runner service. It must be unique across all the
+    #   running App Runner services in your Amazon Web Services account in the
+    #   Amazon Web Services Region.
     #
     # @option params [required, Types::SourceConfiguration] :source_configuration
     #   The source to deploy to the App Runner service. It can be a code or an
@@ -605,23 +616,27 @@ module Aws::AppRunner
     #   Runner service.
     #
     # @option params [Array<Types::Tag>] :tags
-    #   An optional list of metadata items that you can associate with your
-    #   service resource. A tag is a key-value pair.
+    #   An optional list of metadata items that you can associate with the App
+    #   Runner service resource. A tag is a key-value pair.
     #
     # @option params [Types::EncryptionConfiguration] :encryption_configuration
     #   An optional custom encryption key that App Runner uses to encrypt the
     #   copy of your source repository that it maintains and your service
-    #   logs. By default, App Runner uses an Amazon Web Services managed CMK.
+    #   logs. By default, App Runner uses an Amazon Web Services managed key.
     #
     # @option params [Types::HealthCheckConfiguration] :health_check_configuration
     #   The settings for the health check that App Runner performs to monitor
-    #   the health of your service.
+    #   the health of the App Runner service.
     #
     # @option params [String] :auto_scaling_configuration_arn
     #   The Amazon Resource Name (ARN) of an App Runner automatic scaling
-    #   configuration resource that you want to associate with your service.
-    #   If not provided, App Runner associates the latest revision of a
-    #   default auto scaling configuration.
+    #   configuration resource that you want to associate with the App Runner
+    #   service. If not provided, App Runner associates the latest revision of
+    #   a default auto scaling configuration.
+    #
+    # @option params [Types::NetworkConfiguration] :network_configuration
+    #   Configuration settings related to network traffic of the web
+    #   application that the App Runner service runs.
     #
     # @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -658,7 +673,7 @@ module Aws::AppRunner
     #           runtime_environment_variables: {
     #             "RuntimeEnvironmentVariablesKey" => "RuntimeEnvironmentVariablesValue",
     #           },
-    #           start_command: "String",
+    #           start_command: "StartCommand",
     #           port: "String",
     #         },
     #         image_repository_type: "ECR", # required, accepts ECR, ECR_PUBLIC
@@ -692,6 +707,12 @@ module Aws::AppRunner
     #       unhealthy_threshold: 1,
     #     },
     #     auto_scaling_configuration_arn: "AppRunnerResourceArn",
+    #     network_configuration: {
+    #       egress_configuration: {
+    #         egress_type: "DEFAULT", # accepts DEFAULT, VPC
+    #         vpc_connector_arn: "AppRunnerResourceArn",
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -736,6 +757,8 @@ module Aws::AppRunner
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_arn #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_name #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_revision #=> Integer
+    #   resp.service.network_configuration.egress_configuration.egress_type #=> String, one of "DEFAULT", "VPC"
+    #   resp.service.network_configuration.egress_configuration.vpc_connector_arn #=> String
     #   resp.operation_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/CreateService AWS API Documentation
@@ -747,6 +770,69 @@ module Aws::AppRunner
       req.send_request(options)
     end
 
+    # Create an App Runner VPC connector resource. App Runner requires this
+    # resource when you want to associate your App Runner service to a
+    # custom Amazon Virtual Private Cloud (Amazon VPC).
+    #
+    # @option params [required, String] :vpc_connector_name
+    #   A name for the VPC connector.
+    #
+    # @option params [required, Array<String>] :subnets
+    #   A list of IDs of subnets that App Runner should use when it associates
+    #   your service with a custom Amazon VPC. Specify IDs of subnets of a
+    #   single Amazon VPC. App Runner determines the Amazon VPC from the
+    #   subnets you specify.
+    #
+    # @option params [Array<String>] :security_groups
+    #   A list of IDs of security groups that App Runner should use for access
+    #   to Amazon Web Services resources under the specified subnets. If not
+    #   specified, App Runner uses the default security group of the Amazon
+    #   VPC. The default security group allows all outbound traffic.
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of metadata items that you can associate with your VPC
+    #   connector resource. A tag is a key-value pair.
+    #
+    # @return [Types::CreateVpcConnectorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateVpcConnectorResponse#vpc_connector #vpc_connector} => Types::VpcConnector
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_vpc_connector({
+    #     vpc_connector_name: "VpcConnectorName", # required
+    #     subnets: ["String"], # required
+    #     security_groups: ["String"],
+    #     tags: [
+    #       {
+    #         key: "TagKey",
+    #         value: "TagValue",
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.vpc_connector.vpc_connector_name #=> String
+    #   resp.vpc_connector.vpc_connector_arn #=> String
+    #   resp.vpc_connector.vpc_connector_revision #=> Integer
+    #   resp.vpc_connector.subnets #=> Array
+    #   resp.vpc_connector.subnets[0] #=> String
+    #   resp.vpc_connector.security_groups #=> Array
+    #   resp.vpc_connector.security_groups[0] #=> String
+    #   resp.vpc_connector.status #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.vpc_connector.created_at #=> Time
+    #   resp.vpc_connector.deleted_at #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/CreateVpcConnector AWS API Documentation
+    #
+    # @overload create_vpc_connector(params = {})
+    # @param [Hash] params ({})
+    def create_vpc_connector(params = {}, options = {})
+      req = build_request(:create_vpc_connector, params)
+      req.send_request(options)
+    end
+
     # Delete an App Runner automatic scaling configuration resource. You can
     # delete a specific revision or the latest active revision. You can't
     # delete a configuration that's used by one or more App Runner
@@ -890,6 +976,8 @@ module Aws::AppRunner
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_arn #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_name #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_revision #=> Integer
+    #   resp.service.network_configuration.egress_configuration.egress_type #=> String, one of "DEFAULT", "VPC"
+    #   resp.service.network_configuration.egress_configuration.vpc_connector_arn #=> String
     #   resp.operation_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/DeleteService AWS API Documentation
@@ -901,6 +989,47 @@ module Aws::AppRunner
       req.send_request(options)
     end
 
+    # Delete an App Runner VPC connector resource. You can't delete a
+    # connector that's used by one or more App Runner services.
+    #
+    # @option params [required, String] :vpc_connector_arn
+    #   The Amazon Resource Name (ARN) of the App Runner VPC connector that
+    #   you want to delete.
+    #
+    #   The ARN must be a full VPC connector ARN.
+    #
+    # @return [Types::DeleteVpcConnectorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteVpcConnectorResponse#vpc_connector #vpc_connector} => Types::VpcConnector
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_vpc_connector({
+    #     vpc_connector_arn: "AppRunnerResourceArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.vpc_connector.vpc_connector_name #=> String
+    #   resp.vpc_connector.vpc_connector_arn #=> String
+    #   resp.vpc_connector.vpc_connector_revision #=> Integer
+    #   resp.vpc_connector.subnets #=> Array
+    #   resp.vpc_connector.subnets[0] #=> String
+    #   resp.vpc_connector.security_groups #=> Array
+    #   resp.vpc_connector.security_groups[0] #=> String
+    #   resp.vpc_connector.status #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.vpc_connector.created_at #=> Time
+    #   resp.vpc_connector.deleted_at #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/DeleteVpcConnector AWS API Documentation
+    #
+    # @overload delete_vpc_connector(params = {})
+    # @param [Hash] params ({})
+    def delete_vpc_connector(params = {}, options = {})
+      req = build_request(:delete_vpc_connector, params)
+      req.send_request(options)
+    end
+
     # Return a full description of an App Runner automatic scaling
     # configuration resource.
     #
@@ -1066,6 +1195,8 @@ module Aws::AppRunner
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_arn #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_name #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_revision #=> Integer
+    #   resp.service.network_configuration.egress_configuration.egress_type #=> String, one of "DEFAULT", "VPC"
+    #   resp.service.network_configuration.egress_configuration.vpc_connector_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/DescribeService AWS API Documentation
     #
@@ -1076,6 +1207,46 @@ module Aws::AppRunner
       req.send_request(options)
     end
 
+    # Return a description of an App Runner VPC connector resource.
+    #
+    # @option params [required, String] :vpc_connector_arn
+    #   The Amazon Resource Name (ARN) of the App Runner VPC connector that
+    #   you want a description for.
+    #
+    #   The ARN must be a full VPC connector ARN.
+    #
+    # @return [Types::DescribeVpcConnectorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeVpcConnectorResponse#vpc_connector #vpc_connector} => Types::VpcConnector
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_vpc_connector({
+    #     vpc_connector_arn: "AppRunnerResourceArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.vpc_connector.vpc_connector_name #=> String
+    #   resp.vpc_connector.vpc_connector_arn #=> String
+    #   resp.vpc_connector.vpc_connector_revision #=> Integer
+    #   resp.vpc_connector.subnets #=> Array
+    #   resp.vpc_connector.subnets[0] #=> String
+    #   resp.vpc_connector.security_groups #=> Array
+    #   resp.vpc_connector.security_groups[0] #=> String
+    #   resp.vpc_connector.status #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.vpc_connector.created_at #=> Time
+    #   resp.vpc_connector.deleted_at #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/DescribeVpcConnector AWS API Documentation
+    #
+    # @overload describe_vpc_connector(params = {})
+    # @param [Hash] params ({})
+    def describe_vpc_connector(params = {}, options = {})
+      req = build_request(:describe_vpc_connector, params)
+      req.send_request(options)
+    end
+
     # Disassociate a custom domain name from an App Runner service.
     #
     # Certificates tracking domain validity are associated with a custom
@@ -1405,6 +1576,63 @@ module Aws::AppRunner
       req.send_request(options)
     end
 
+    # Returns a list of App Runner VPC connectors in your Amazon Web
+    # Services account.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to include in each response (result
+    #   page). It's used for a paginated request.
+    #
+    #   If you don't specify `MaxResults`, the request retrieves all
+    #   available results in a single response.
+    #
+    # @option params [String] :next_token
+    #   A token from a previous result page. It's used for a paginated
+    #   request. The request retrieves the next result page. All other
+    #   parameter values must be identical to the ones that are specified in
+    #   the initial request.
+    #
+    #   If you don't specify `NextToken`, the request retrieves the first
+    #   result page.
+    #
+    # @return [Types::ListVpcConnectorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListVpcConnectorsResponse#vpc_connectors #vpc_connectors} => Array&lt;Types::VpcConnector&gt;
+    #   * {Types::ListVpcConnectorsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_vpc_connectors({
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.vpc_connectors #=> Array
+    #   resp.vpc_connectors[0].vpc_connector_name #=> String
+    #   resp.vpc_connectors[0].vpc_connector_arn #=> String
+    #   resp.vpc_connectors[0].vpc_connector_revision #=> Integer
+    #   resp.vpc_connectors[0].subnets #=> Array
+    #   resp.vpc_connectors[0].subnets[0] #=> String
+    #   resp.vpc_connectors[0].security_groups #=> Array
+    #   resp.vpc_connectors[0].security_groups[0] #=> String
+    #   resp.vpc_connectors[0].status #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.vpc_connectors[0].created_at #=> Time
+    #   resp.vpc_connectors[0].deleted_at #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/ListVpcConnectors AWS API Documentation
+    #
+    # @overload list_vpc_connectors(params = {})
+    # @param [Hash] params ({})
+    def list_vpc_connectors(params = {}, options = {})
+      req = build_request(:list_vpc_connectors, params)
+      req.send_request(options)
+    end
+
     # Pause an active App Runner service. App Runner reduces compute
     # capacity for the service to zero and loses state (for example,
     # ephemeral storage is removed).
@@ -1470,6 +1698,8 @@ module Aws::AppRunner
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_arn #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_name #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_revision #=> Integer
+    #   resp.service.network_configuration.egress_configuration.egress_type #=> String, one of "DEFAULT", "VPC"
+    #   resp.service.network_configuration.egress_configuration.vpc_connector_arn #=> String
     #   resp.operation_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/PauseService AWS API Documentation
@@ -1545,6 +1775,8 @@ module Aws::AppRunner
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_arn #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_name #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_revision #=> Integer
+    #   resp.service.network_configuration.egress_configuration.egress_type #=> String, one of "DEFAULT", "VPC"
+    #   resp.service.network_configuration.egress_configuration.vpc_connector_arn #=> String
     #   resp.operation_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/ResumeService AWS API Documentation
@@ -1699,11 +1931,16 @@ module Aws::AppRunner
     #
     # @option params [String] :auto_scaling_configuration_arn
     #   The Amazon Resource Name (ARN) of an App Runner automatic scaling
-    #   configuration resource that you want to associate with your service.
+    #   configuration resource that you want to associate with the App Runner
+    #   service.
     #
     # @option params [Types::HealthCheckConfiguration] :health_check_configuration
     #   The settings for the health check that App Runner performs to monitor
-    #   the health of your service.
+    #   the health of the App Runner service.
+    #
+    # @option params [Types::NetworkConfiguration] :network_configuration
+    #   Configuration settings related to network traffic of the web
+    #   application that the App Runner service runs.
     #
     # @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1740,7 +1977,7 @@ module Aws::AppRunner
     #           runtime_environment_variables: {
     #             "RuntimeEnvironmentVariablesKey" => "RuntimeEnvironmentVariablesValue",
     #           },
-    #           start_command: "String",
+    #           start_command: "StartCommand",
     #           port: "String",
     #         },
     #         image_repository_type: "ECR", # required, accepts ECR, ECR_PUBLIC
@@ -1765,6 +2002,12 @@ module Aws::AppRunner
     #       healthy_threshold: 1,
     #       unhealthy_threshold: 1,
     #     },
+    #     network_configuration: {
+    #       egress_configuration: {
+    #         egress_type: "DEFAULT", # accepts DEFAULT, VPC
+    #         vpc_connector_arn: "AppRunnerResourceArn",
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -1809,6 +2052,8 @@ module Aws::AppRunner
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_arn #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_name #=> String
     #   resp.service.auto_scaling_configuration_summary.auto_scaling_configuration_revision #=> Integer
+    #   resp.service.network_configuration.egress_configuration.egress_type #=> String, one of "DEFAULT", "VPC"
+    #   resp.service.network_configuration.egress_configuration.vpc_connector_arn #=> String
     #   resp.operation_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/apprunner-2020-05-15/UpdateService AWS API Documentation
@@ -1833,7 +2078,7 @@ module Aws::AppRunner
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-apprunner'
-      context[:gem_version] = '1.9.0'
+      context[:gem_version] = '1.10.0'
       Seahorse::Client::Request.new(handlers, context)
     end