aws-sdk-appsync 1.70.0 → 1.72.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e3c13699726336270b912bfdeb162a2d44a0497093e5ecf981969d38c745fbe
-  data.tar.gz: 11dd1b08794cbb936d6e05fab873f7a834e5a7b472c7c4239c5d6a17a785cfe9
+  metadata.gz: b20be619f0a3cd655e0110ebb06c720a42eed94364ab9f9603ff1e2c99f7cbcf
+  data.tar.gz: 7f2f342dc0d0e3cb50e588571546c10d2680b23ddab2d2a166b94c8c8bf2cda5
 SHA512:
-  metadata.gz: 1e546c54c18cffb4a7ca1e78410f536e2e5b34a6150bcf9d8a6613b665b41829a2798f20124e262337435ce105f671ddc6200dc9f89476e5f349dcb753fe1b2c
-  data.tar.gz: 4eecaa6fc64665ce779ecf96d038ca24a7e1da5dfe0739a0ed8b27acd2b9333a4625b7159c3ec2e45b2813571159ffde7ce0e691edd18d324cbcab59cd98fae7
+  metadata.gz: e5098d28d8fb00135f14769c58119e51a661266c2038444301ab042fff8a91db364105928901ac484cb1fe303941d61d1dd0bdb90c9b2b2d3085bfe5bde77997
+  data.tar.gz: e432b6dd4b507dba0eb1ebd9ad4318d64c9fb8140c3098cc0db0da11e1c062320535e7347f957a4bfda192e619cb733908d98356c6852ee8849dfc8b70a3d6a1

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.72.0 (2024-02-06)
+------------------
+
+* Feature - Support for environment variables in AppSync GraphQL APIs
+
+1.71.0 (2024-01-26)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.70.0 (2023-12-19)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.70.0
+1.72.0

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

@@ -2151,6 +2151,37 @@ module Aws::AppSync
       req.send_request(options)
     end
 
+    # Retrieves the list of environmental variable key-value pairs
+    # associated with an API by its ID value.
+    #
+    # @option params [required, String] :api_id
+    #   The ID of the API from which the environmental variable list will be
+    #   retrieved.
+    #
+    # @return [Types::GetGraphqlApiEnvironmentVariablesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetGraphqlApiEnvironmentVariablesResponse#environment_variables #environment_variables} => Hash<String,String>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_graphql_api_environment_variables({
+    #     api_id: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.environment_variables #=> Hash
+    #   resp.environment_variables["EnvironmentVariableKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetGraphqlApiEnvironmentVariables AWS API Documentation
+    #
+    # @overload get_graphql_api_environment_variables(params = {})
+    # @param [Hash] params ({})
+    def get_graphql_api_environment_variables(params = {}, options = {})
+      req = build_request(:get_graphql_api_environment_variables, params)
+      req.send_request(options)
+    end
+
     # Retrieves the introspection schema for a GraphQL API.
     #
     # @option params [required, String] :api_id
@@ -2974,6 +3005,104 @@ module Aws::AppSync
       req.send_request(options)
     end
 
+    # Creates a list of environmental variables in an API by its ID value.
+    #
+    # When creating an environmental variable, it must follow the
+    # constraints below:
+    #
+    # * Both JavaScript and VTL templates support environmental variables.
+    #
+    # * Environmental variables are not evaluated before function
+    #   invocation.
+    #
+    # * Environmental variables only support string values.
+    #
+    # * Any defined value in an environmental variable is considered a
+    #   string literal and not expanded.
+    #
+    # * Variable evaluations should ideally be performed in the function
+    #   code.
+    #
+    # When creating an environmental variable key-value pair, it must follow
+    # the additional constraints below:
+    #
+    # * Keys must begin with a letter.
+    #
+    # * Keys must be at least two characters long.
+    #
+    # * Keys can only contain letters, numbers, and the underscore character
+    #   (\_).
+    #
+    # * Values can be up to 512 characters long.
+    #
+    # * You can configure up to 50 key-value pairs in a GraphQL API.
+    #
+    # You can create a list of environmental variables by adding it to the
+    # `environmentVariables` payload as a list in the format
+    # `\{"key1":"value1","key2":"value2", …\}`. Note that each call of the
+    # `PutGraphqlApiEnvironmentVariables` action will result in the
+    # overwriting of the existing environmental variable list of that API.
+    # This means the existing environmental variables will be lost. To avoid
+    # this, you must include all existing and new environmental variables in
+    # the list each time you call this action.
+    #
+    # @option params [required, String] :api_id
+    #   The ID of the API to which the environmental variable list will be
+    #   written.
+    #
+    # @option params [required, Hash<String,String>] :environment_variables
+    #   The list of environmental variables to add to the API.
+    #
+    #   When creating an environmental variable key-value pair, it must follow
+    #   the additional constraints below:
+    #
+    #   * Keys must begin with a letter.
+    #
+    #   * Keys must be at least two characters long.
+    #
+    #   * Keys can only contain letters, numbers, and the underscore character
+    #     (\_).
+    #
+    #   * Values can be up to 512 characters long.
+    #
+    #   * You can configure up to 50 key-value pairs in a GraphQL API.
+    #
+    #   You can create a list of environmental variables by adding it to the
+    #   `environmentVariables` payload as a list in the format
+    #   `\{"key1":"value1","key2":"value2", …\}`. Note that each call of the
+    #   `PutGraphqlApiEnvironmentVariables` action will result in the
+    #   overwriting of the existing environmental variable list of that API.
+    #   This means the existing environmental variables will be lost. To avoid
+    #   this, you must include all existing and new environmental variables in
+    #   the list each time you call this action.
+    #
+    # @return [Types::PutGraphqlApiEnvironmentVariablesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::PutGraphqlApiEnvironmentVariablesResponse#environment_variables #environment_variables} => Hash&lt;String,String&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_graphql_api_environment_variables({
+    #     api_id: "String", # required
+    #     environment_variables: { # required
+    #       "EnvironmentVariableKey" => "EnvironmentVariableValue",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.environment_variables #=> Hash
+    #   resp.environment_variables["EnvironmentVariableKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/PutGraphqlApiEnvironmentVariables AWS API Documentation
+    #
+    # @overload put_graphql_api_environment_variables(params = {})
+    # @param [Hash] params ({})
+    def put_graphql_api_environment_variables(params = {}, options = {})
+      req = build_request(:put_graphql_api_environment_variables, params)
+      req.send_request(options)
+    end
+
     # Creates a new introspection. Returns the `introspectionId` of the new
     # introspection after its creation.
     #
@@ -3998,7 +4127,7 @@ module Aws::AppSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-appsync'
-      context[:gem_version] = '1.70.0'
+      context[:gem_version] = '1.72.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -120,6 +120,9 @@ module Aws::AppSync
     DomainNameConfigs = Shapes::ListShape.new(name: 'DomainNameConfigs')
     DynamodbDataSourceConfig = Shapes::StructureShape.new(name: 'DynamodbDataSourceConfig')
     ElasticsearchDataSourceConfig = Shapes::StructureShape.new(name: 'ElasticsearchDataSourceConfig')
+    EnvironmentVariableKey = Shapes::StringShape.new(name: 'EnvironmentVariableKey')
+    EnvironmentVariableMap = Shapes::MapShape.new(name: 'EnvironmentVariableMap')
+    EnvironmentVariableValue = Shapes::StringShape.new(name: 'EnvironmentVariableValue')
     ErrorDetail = Shapes::StructureShape.new(name: 'ErrorDetail')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     EvaluateCodeErrorDetail = Shapes::StructureShape.new(name: 'EvaluateCodeErrorDetail')
@@ -147,6 +150,8 @@ module Aws::AppSync
     GetDomainNameResponse = Shapes::StructureShape.new(name: 'GetDomainNameResponse')
     GetFunctionRequest = Shapes::StructureShape.new(name: 'GetFunctionRequest')
     GetFunctionResponse = Shapes::StructureShape.new(name: 'GetFunctionResponse')
+    GetGraphqlApiEnvironmentVariablesRequest = Shapes::StructureShape.new(name: 'GetGraphqlApiEnvironmentVariablesRequest')
+    GetGraphqlApiEnvironmentVariablesResponse = Shapes::StructureShape.new(name: 'GetGraphqlApiEnvironmentVariablesResponse')
     GetGraphqlApiRequest = Shapes::StructureShape.new(name: 'GetGraphqlApiRequest')
     GetGraphqlApiResponse = Shapes::StructureShape.new(name: 'GetGraphqlApiResponse')
     GetIntrospectionSchemaRequest = Shapes::StructureShape.new(name: 'GetIntrospectionSchemaRequest')
@@ -208,6 +213,8 @@ module Aws::AppSync
     Ownership = Shapes::StringShape.new(name: 'Ownership')
     PaginationToken = Shapes::StringShape.new(name: 'PaginationToken')
     PipelineConfig = Shapes::StructureShape.new(name: 'PipelineConfig')
+    PutGraphqlApiEnvironmentVariablesRequest = Shapes::StructureShape.new(name: 'PutGraphqlApiEnvironmentVariablesRequest')
+    PutGraphqlApiEnvironmentVariablesResponse = Shapes::StructureShape.new(name: 'PutGraphqlApiEnvironmentVariablesResponse')
     QueryDepthLimit = Shapes::IntegerShape.new(name: 'QueryDepthLimit')
     RdsDataApiConfig = Shapes::StructureShape.new(name: 'RdsDataApiConfig')
     RdsDataApiConfigDatabaseName = Shapes::StringShape.new(name: 'RdsDataApiConfigDatabaseName')
@@ -633,6 +640,9 @@ module Aws::AppSync
     ElasticsearchDataSourceConfig.add_member(:aws_region, Shapes::ShapeRef.new(shape: String, required: true, location_name: "awsRegion"))
     ElasticsearchDataSourceConfig.struct_class = Types::ElasticsearchDataSourceConfig
 
+    EnvironmentVariableMap.key = Shapes::ShapeRef.new(shape: EnvironmentVariableKey)
+    EnvironmentVariableMap.value = Shapes::ShapeRef.new(shape: EnvironmentVariableValue)
+
     ErrorDetail.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     ErrorDetail.struct_class = Types::ErrorDetail
 
@@ -730,6 +740,12 @@ module Aws::AppSync
     GetFunctionResponse.add_member(:function_configuration, Shapes::ShapeRef.new(shape: FunctionConfiguration, location_name: "functionConfiguration"))
     GetFunctionResponse.struct_class = Types::GetFunctionResponse
 
+    GetGraphqlApiEnvironmentVariablesRequest.add_member(:api_id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "apiId"))
+    GetGraphqlApiEnvironmentVariablesRequest.struct_class = Types::GetGraphqlApiEnvironmentVariablesRequest
+
+    GetGraphqlApiEnvironmentVariablesResponse.add_member(:environment_variables, Shapes::ShapeRef.new(shape: EnvironmentVariableMap, location_name: "environmentVariables"))
+    GetGraphqlApiEnvironmentVariablesResponse.struct_class = Types::GetGraphqlApiEnvironmentVariablesResponse
+
     GetGraphqlApiRequest.add_member(:api_id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "apiId"))
     GetGraphqlApiRequest.struct_class = Types::GetGraphqlApiRequest
 
@@ -953,6 +969,13 @@ module Aws::AppSync
     PipelineConfig.add_member(:functions, Shapes::ShapeRef.new(shape: FunctionsIds, location_name: "functions"))
     PipelineConfig.struct_class = Types::PipelineConfig
 
+    PutGraphqlApiEnvironmentVariablesRequest.add_member(:api_id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "apiId"))
+    PutGraphqlApiEnvironmentVariablesRequest.add_member(:environment_variables, Shapes::ShapeRef.new(shape: EnvironmentVariableMap, required: true, location_name: "environmentVariables"))
+    PutGraphqlApiEnvironmentVariablesRequest.struct_class = Types::PutGraphqlApiEnvironmentVariablesRequest
+
+    PutGraphqlApiEnvironmentVariablesResponse.add_member(:environment_variables, Shapes::ShapeRef.new(shape: EnvironmentVariableMap, location_name: "environmentVariables"))
+    PutGraphqlApiEnvironmentVariablesResponse.struct_class = Types::PutGraphqlApiEnvironmentVariablesResponse
+
     RdsDataApiConfig.add_member(:resource_arn, Shapes::ShapeRef.new(shape: RdsDataApiConfigResourceArn, required: true, location_name: "resourceArn"))
     RdsDataApiConfig.add_member(:secret_arn, Shapes::ShapeRef.new(shape: RdsDataApiConfigSecretArn, required: true, location_name: "secretArn"))
     RdsDataApiConfig.add_member(:database_name, Shapes::ShapeRef.new(shape: RdsDataApiConfigDatabaseName, required: true, location_name: "databaseName"))
@@ -1615,6 +1638,19 @@ module Aws::AppSync
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
       end)
 
+      api.add_operation(:get_graphql_api_environment_variables, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetGraphqlApiEnvironmentVariables"
+        o.http_method = "GET"
+        o.http_request_uri = "/v1/apis/{apiId}/environmentVariables"
+        o.input = Shapes::ShapeRef.new(shape: GetGraphqlApiEnvironmentVariablesRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetGraphqlApiEnvironmentVariablesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BadRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalFailureException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
       api.add_operation(:get_introspection_schema, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetIntrospectionSchema"
         o.http_method = "GET"
@@ -1809,6 +1845,20 @@ module Aws::AppSync
         o.errors << Shapes::ShapeRef.new(shape: InternalFailureException)
       end)
 
+      api.add_operation(:put_graphql_api_environment_variables, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutGraphqlApiEnvironmentVariables"
+        o.http_method = "PUT"
+        o.http_request_uri = "/v1/apis/{apiId}/environmentVariables"
+        o.input = Shapes::ShapeRef.new(shape: PutGraphqlApiEnvironmentVariablesRequest)
+        o.output = Shapes::ShapeRef.new(shape: PutGraphqlApiEnvironmentVariablesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BadRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: ConcurrentModificationException)
+        o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalFailureException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
       api.add_operation(:start_data_source_introspection, Seahorse::Model::Operation.new.tap do |o|
         o.name = "StartDataSourceIntrospection"
         o.http_method = "POST"

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

@@ -460,6 +460,20 @@ module Aws::AppSync
       end
     end
 
+    class GetGraphqlApiEnvironmentVariables
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::AppSync::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class GetIntrospectionSchema
       def self.build(context)
         unless context.config.regional_endpoint
@@ -684,6 +698,20 @@ module Aws::AppSync
       end
     end
 
+    class PutGraphqlApiEnvironmentVariables
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::AppSync::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class StartDataSourceIntrospection
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-appsync/plugins/endpoints.rb

@@ -14,6 +14,7 @@ module Aws::AppSync
       option(
         :endpoint_provider,
         doc_type: 'Aws::AppSync::EndpointProvider',
+        rbs_type: 'untyped',
         docstring: 'The endpoint provider used to resolve endpoints. Any '\
                    'object that responds to `#resolve_endpoint(parameters)` '\
                    'where `parameters` is a Struct similar to '\
@@ -121,6 +122,8 @@ module Aws::AppSync
             Aws::AppSync::Endpoints::GetFunction.build(context)
           when :get_graphql_api
             Aws::AppSync::Endpoints::GetGraphqlApi.build(context)
+          when :get_graphql_api_environment_variables
+            Aws::AppSync::Endpoints::GetGraphqlApiEnvironmentVariables.build(context)
           when :get_introspection_schema
             Aws::AppSync::Endpoints::GetIntrospectionSchema.build(context)
           when :get_resolver
@@ -153,6 +156,8 @@ module Aws::AppSync
             Aws::AppSync::Endpoints::ListTypes.build(context)
           when :list_types_by_association
             Aws::AppSync::Endpoints::ListTypesByAssociation.build(context)
+          when :put_graphql_api_environment_variables
+            Aws::AppSync::Endpoints::PutGraphqlApiEnvironmentVariables.build(context)
           when :start_data_source_introspection
             Aws::AppSync::Endpoints::StartDataSourceIntrospection.build(context)
           when :start_schema_creation

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

@@ -2348,6 +2348,32 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # @!attribute [rw] api_id
+    #   The ID of the API from which the environmental variable list will be
+    #   retrieved.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetGraphqlApiEnvironmentVariablesRequest AWS API Documentation
+    #
+    class GetGraphqlApiEnvironmentVariablesRequest < Struct.new(
+      :api_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] environment_variables
+    #   The payload containing each environmental variable in the `"key" :
+    #   "value"` format.
+    #   @return [Hash<String,String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/GetGraphqlApiEnvironmentVariablesResponse AWS API Documentation
+    #
+    class GetGraphqlApiEnvironmentVariablesResponse < Struct.new(
+      :environment_variables)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] api_id
     #   The API ID for the GraphQL API.
     #   @return [String]
@@ -3448,6 +3474,60 @@ module Aws::AppSync
       include Aws::Structure
     end
 
+    # @!attribute [rw] api_id
+    #   The ID of the API to which the environmental variable list will be
+    #   written.
+    #   @return [String]
+    #
+    # @!attribute [rw] environment_variables
+    #   The list of environmental variables to add to the API.
+    #
+    #   When creating an environmental variable key-value pair, it must
+    #   follow the additional constraints below:
+    #
+    #   * Keys must begin with a letter.
+    #
+    #   * Keys must be at least two characters long.
+    #
+    #   * Keys can only contain letters, numbers, and the underscore
+    #     character (\_).
+    #
+    #   * Values can be up to 512 characters long.
+    #
+    #   * You can configure up to 50 key-value pairs in a GraphQL API.
+    #
+    #   You can create a list of environmental variables by adding it to the
+    #   `environmentVariables` payload as a list in the format
+    #   `\{"key1":"value1","key2":"value2", …\}`. Note that each call of the
+    #   `PutGraphqlApiEnvironmentVariables` action will result in the
+    #   overwriting of the existing environmental variable list of that API.
+    #   This means the existing environmental variables will be lost. To
+    #   avoid this, you must include all existing and new environmental
+    #   variables in the list each time you call this action.
+    #   @return [Hash<String,String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/PutGraphqlApiEnvironmentVariablesRequest AWS API Documentation
+    #
+    class PutGraphqlApiEnvironmentVariablesRequest < Struct.new(
+      :api_id,
+      :environment_variables)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] environment_variables
+    #   The payload containing each environmental variable in the `"key" :
+    #   "value"` format.
+    #   @return [Hash<String,String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/PutGraphqlApiEnvironmentVariablesResponse AWS API Documentation
+    #
+    class PutGraphqlApiEnvironmentVariablesResponse < Struct.new(
+      :environment_variables)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains the metadata required to introspect the RDS cluster.
     #
     # @!attribute [rw] resource_arn

data/lib/aws-sdk-appsync.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-appsync/customizations'
 # @!group service
 module Aws::AppSync
 
-  GEM_VERSION = '1.70.0'
+  GEM_VERSION = '1.72.0'
 
 end