AWS AppSync

2024/02/06 - AWS AppSync - 2 new api methods

Changes  Support for environment variables in AppSync GraphQL APIs

PutGraphqlApiEnvironmentVariables (new) Link ¶

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.

See also: AWS API Documentation

Request Syntax

client.put_graphql_api_environment_variables(
    apiId='string',
    environmentVariables={
        'string': 'string'
    }
)
type apiId:

string

param apiId:

[REQUIRED]

The ID of the API to which the environmental variable list will be written.

type environmentVariables:

dict

param environmentVariables:

[REQUIRED]

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.

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'environmentVariables': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • environmentVariables (dict) --

      The payload containing each environmental variable in the "key" : "value" format.

      • (string) --

        • (string) --

GetGraphqlApiEnvironmentVariables (new) Link ¶

Retrieves the list of environmental variable key-value pairs associated with an API by its ID value.

See also: AWS API Documentation

Request Syntax

client.get_graphql_api_environment_variables(
    apiId='string'
)
type apiId:

string

param apiId:

[REQUIRED]

The ID of the API from which the environmental variable list will be retrieved.

rtype:

dict

returns:

Response Syntax

{
    'environmentVariables': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • environmentVariables (dict) --

      The payload containing each environmental variable in the "key" : "value" format.

      • (string) --

        • (string) --