Package software.amazon.awscdk.services.appsync

Interface CfnGraphQLApiProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnGraphQLApiProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)",
           date="2023-06-19T16:30:49.446Z")
@Stability(Stable)
public interface CfnGraphQLApiProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnGraphQLApi.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.appsync.*;
 CfnGraphQLApiProps cfnGraphQLApiProps = CfnGraphQLApiProps.builder()
         .authenticationType("authenticationType")
         .name("name")
         // the properties below are optional
         .additionalAuthenticationProviders(List.of(AdditionalAuthenticationProviderProperty.builder()
                 .authenticationType("authenticationType")
                 // the properties below are optional
                 .lambdaAuthorizerConfig(LambdaAuthorizerConfigProperty.builder()
                         .authorizerResultTtlInSeconds(123)
                         .authorizerUri("authorizerUri")
                         .identityValidationExpression("identityValidationExpression")
                         .build())
                 .openIdConnectConfig(OpenIDConnectConfigProperty.builder()
                         .authTtl(123)
                         .clientId("clientId")
                         .iatTtl(123)
                         .issuer("issuer")
                         .build())
                 .userPoolConfig(CognitoUserPoolConfigProperty.builder()
                         .appIdClientRegex("appIdClientRegex")
                         .awsRegion("awsRegion")
                         .userPoolId("userPoolId")
                         .build())
                 .build()))
         .apiType("apiType")
         .lambdaAuthorizerConfig(LambdaAuthorizerConfigProperty.builder()
                 .authorizerResultTtlInSeconds(123)
                 .authorizerUri("authorizerUri")
                 .identityValidationExpression("identityValidationExpression")
                 .build())
         .logConfig(LogConfigProperty.builder()
                 .cloudWatchLogsRoleArn("cloudWatchLogsRoleArn")
                 .excludeVerboseContent(false)
                 .fieldLogLevel("fieldLogLevel")
                 .build())
         .mergedApiExecutionRoleArn("mergedApiExecutionRoleArn")
         .openIdConnectConfig(OpenIDConnectConfigProperty.builder()
                 .authTtl(123)
                 .clientId("clientId")
                 .iatTtl(123)
                 .issuer("issuer")
                 .build())
         .ownerContact("ownerContact")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .userPoolConfig(UserPoolConfigProperty.builder()
                 .appIdClientRegex("appIdClientRegex")
                 .awsRegion("awsRegion")
                 .defaultAction("defaultAction")
                 .userPoolId("userPoolId")
                 .build())
         .visibility("visibility")
         .xrayEnabled(false)
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnGraphQLApiProps.Builder	A builder for CfnGraphQLApiProps
static final class	CfnGraphQLApiProps.Jsii$Proxy	An implementation for CfnGraphQLApiProps

Method Summary

Modifier and Type	Method	Description
static CfnGraphQLApiProps.Builder	builder()
default Object	getAdditionalAuthenticationProviders()	A list of additional authentication providers for the GraphqlApi API.
default String	getApiType()	The value that indicates whether the GraphQL API is a standard API ( GRAPHQL ) or merged API ( MERGED ).
String	getAuthenticationType()	Security configuration for your GraphQL API.
default Object	getLambdaAuthorizerConfig()	A LambdaAuthorizerConfig holds configuration on how to authorize AWS AppSync API access when using the AWS_LAMBDA authorizer mode.
default Object	getLogConfig()	The Amazon CloudWatch Logs configuration.
default String	getMergedApiExecutionRoleArn()	The AWS Identity and Access Management service role ARN for a merged API.
String	getName()	The API name.
default Object	getOpenIdConnectConfig()	The OpenID Connect configuration.
default String	getOwnerContact()	The owner contact information for an API resource.
default List<CfnTag>	getTags()	An arbitrary set of tags (key-value pairs) for this GraphQL API.
default Object	getUserPoolConfig()	Optional authorization configuration for using Amazon Cognito user pools with your GraphQL endpoint.
default String	getVisibility()	Sets the scope of the GraphQL API to public ( GLOBAL ) or private ( PRIVATE ).
default Object	getXrayEnabled()	A flag indicating whether to use AWS X-Ray tracing for this GraphqlApi .

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getAuthenticationType

@Stability(Stable)
@NotNull
String getAuthenticationType()

Security configuration for your GraphQL API.

For allowed values (such as API_KEY , AWS_IAM , AMAZON_COGNITO_USER_POOLS , OPENID_CONNECT , or AWS_LAMBDA ), see Security in the AWS AppSync Developer Guide .

getName

@Stability(Stable)
@NotNull
String getName()

The API name.

getAdditionalAuthenticationProviders

@Stability(Stable)
@Nullable
default Object getAdditionalAuthenticationProviders()

A list of additional authentication providers for the GraphqlApi API.

getApiType

@Stability(Stable)
@Nullable
default String getApiType()

The value that indicates whether the GraphQL API is a standard API ( GRAPHQL ) or merged API ( MERGED ).

The following values are valid:

GRAPHQL | MERGED

getLambdaAuthorizerConfig

@Stability(Stable)
@Nullable
default Object getLambdaAuthorizerConfig()

A LambdaAuthorizerConfig holds configuration on how to authorize AWS AppSync API access when using the AWS_LAMBDA authorizer mode.

Be aware that an AWS AppSync API may have only one Lambda authorizer configured at a time.

getLogConfig

@Stability(Stable)
@Nullable
default Object getLogConfig()

The Amazon CloudWatch Logs configuration.

getMergedApiExecutionRoleArn

@Stability(Stable)
@Nullable
default String getMergedApiExecutionRoleArn()

The AWS Identity and Access Management service role ARN for a merged API.

The AppSync service assumes this role on behalf of the Merged API to validate access to source APIs at runtime and to prompt the AUTO_MERGE to update the merged API endpoint with the source API changes automatically.

getOpenIdConnectConfig

@Stability(Stable)
@Nullable
default Object getOpenIdConnectConfig()

The OpenID Connect configuration.

getOwnerContact

@Stability(Stable)
@Nullable
default String getOwnerContact()

The owner contact information for an API resource.

This field accepts any string input with a length of 0 - 256 characters.

getTags

@Stability(Stable)
@Nullable
default List<CfnTag> getTags()

An arbitrary set of tags (key-value pairs) for this GraphQL API.

getUserPoolConfig

@Stability(Stable)
@Nullable
default Object getUserPoolConfig()

Optional authorization configuration for using Amazon Cognito user pools with your GraphQL endpoint.

getVisibility

@Stability(Stable)
@Nullable
default String getVisibility()

Sets the scope of the GraphQL API to public ( GLOBAL ) or private ( PRIVATE ).

By default, the scope is set to Global if no value is provided.

getXrayEnabled

@Stability(Stable)
@Nullable
default Object getXrayEnabled()

A flag indicating whether to use AWS X-Ray tracing for this GraphqlApi .

builder

@Stability(Stable)
static CfnGraphQLApiProps.Builder builder()

Returns:

a CfnGraphQLApiProps.Builder of CfnGraphQLApiProps