기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS::Serverless::GraphQLApi
<a name="sam-resource-graphqlapi"></a>

 AWS Serverless Application Model (AWS SAM) `AWS::Serverless::GraphQLApi` 리소스 유형을 사용하여 서버리스 애플리케이션에 대한 API를 AWS AppSync GraphQL 생성하고 구성합니다.

자세한 내용은 *AWS AppSync 개발자 안내서*의 [란 무엇입니까 AWS AppSync?](https://docs.aws.amazon.com/appsync/latest/devguide/what-is-appsync.html)를 AWS AppSync참조하세요.

## 구문
<a name="sam-resource-graphqlapi-syntax"></a>

### YAML
<a name="sam-resource-graphqlapi-syntax-yaml"></a>

```
LogicalId:
  Type: AWS::Serverless::GraphQLApi
  Properties:
    ApiKeys: ApiKeys
    Auth: Auth
    Cache: [AWS::AppSync::ApiCache](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apicache.html)
    DataSources: DataSource
    DomainName: [AWS::AppSync::DomainName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-domainname.html)
    Functions: Function
    Logging: [LogConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-logconfig.html)
    Name: String
    Resolvers: Resolver
    SchemaInline: String
    SchemaUri: String
    Tags:
    - [Tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html)
    XrayEnabled: Boolean
```

## 속성
<a name="sam-resource-graphqlapi-properties"></a>

`ApiKeys`  <a name="sam-graphqlapi-apikeys"></a>
API 키가 필요한 GraphQL 작업을 수행하는 데 사용할 수 있는 고유 키를 생성합니다.  
*유형*: [APIKey](sam-property-graphqlapi-apikeys.md)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`Auth`  <a name="sam-graphqlapi-auth"></a>
GraphQLAPI에 대한 인증을 구성하십시오.  
*유형*: [인증](sam-property-graphqlapi-auth.md)  
*필수 여부*: 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`Cache`  <a name="sam-graphqlapi-cache"></a>
`CreateApiCache` 작업의 입력.  
*유형*: [AWS::AppSync::ApiCache](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apicache.html)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 [AWS::AppSync::ApiCache](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apicache.html) 리소스로 직접 전달됩니다.

`DataSources`  <a name="sam-graphqlapi-datasources"></a>
에서 연결할 함수 AWS AppSync 에 대한 데이터 소스를 생성합니다.는 Amazon DynamoDB 및 AWS Lambda 데이터 소스를 AWS SAM 지원합니다.  
*유형*: [DataSource](sam-property-graphqlapi-datasource.md)  
*필수 항목 여부*: 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`DomainName`  <a name="sam-graphqlapi-domainname"></a>
GraphQLAPI에 대한 사용자 지정 도메인 이름.  
*유형*: [AWS::AppSync::DomainName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-domainname.html)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 [AWS::AppSync::DomainName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-domainname.html) 리소스에 직접 전달됩니다. AWS SAM 는 [AWS::AppSync::DomainNameApiAssociation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-domainnameapiassociation.html) 리소스를 자동으로 생성합니다.

`Functions`  <a name="sam-graphqlapi-functions"></a>
특정 작업을 수행하도록 GraphQL API의 함수를 구성합니다.  
*유형*[: 함수](sam-property-graphqlapi-function.md)  
*필수 여부*: 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`Logging`  <a name="sam-graphqlapi-logging"></a>
GraphQL API에 대한 Amazon CloudWatch 로깅을 구성합니다.   
이 속성을 지정하지 않으면 AWS SAM 가 다음 값을 `CloudWatchLogsRoleArn` 생성하고 설정합니다.  
+ `ExcludeVerboseContent: true`
+ `FieldLogLevel: ALL`
로깅을 배제하려면 다음을 지정합니다.  

```
Logging: false
```
*유형*: [LogConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-logconfig.html)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[LogConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-logconfig)` 속성으로 직접 전달됩니다.

`LogicalId`  <a name="sam-graphqlapi-logicalid"></a>
GraphQL API의 고유한 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-name)` 속성으로 직접 전달됩니다.

`Name`  <a name="sam-graphqlapi-name"></a>
귀하의 GraphQLAPI의 이름입니다. 이 속성을 지정하여 `LogicalId` 값을 재정의합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-name)` 속성으로 직접 전달됩니다.

`Resolvers`  <a name="sam-graphqlapi-resolvers"></a>
귀하의 GraphQL API 필드에 대한 해석기를 구성하십시오. AWS SAM 는 [JavaScript파이프라인](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-overview-js.html#anatomy-of-a-pipeline-resolver-js) 리졸버를 지원합니다.  
*유형:* [해석기](sam-property-graphqlapi-resolver.md)  
*필수 여부*: 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`SchemaInline`  <a name="sam-graphqlapi-schemainline"></a>
SDL 형식의 GraphQL 스키마 텍스트 표시.  
*유형*: 문자열  
*필수 항목 여부*: 조건부. `SchemaInline` 또는`SchemaUri` 를 지정해야 합니다.  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLSchema` 리소스의 `[Definition](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlschema.html#cfn-appsync-graphqlschema-definition)` 속성으로 직접 전달됩니다.

`SchemaUri`  <a name="sam-graphqlapi-schemauri"></a>
스키마의 Amazon Simple Storage Service(S3) 버킷 URI 또는 로컬 폴더 경로  
로컬 폴더의 경로를 지정하는 경우 배포 전에 파일을 먼저 Amazon S3에 업로드해야 CloudFormation 합니다. AWS SAMCLI를 사용하여 이 프로세스를 용이하게 할 수 있습니다. 자세한 내용은 [가 배포 시 로컬 파일을 AWS SAM 업로드하는 방법](deploy-upload-local-files.md)을 참조하십시오  
*유형*: 문자열  
*필수 항목 여부*: 조건부. `SchemaInline` 또는`SchemaUri` 를 지정해야 합니다.  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLSchema` 리소스의 `[DefinitionS3Location](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlschema.html#cfn-appsync-graphqlschema-definitions3location)` 속성으로 직접 전달됩니다.

`Tags`  <a name="sam-graphqlapi-tags"></a>
이 GraphQL API에 대한 태그(키-값 페어)입니다. 태그를 사용하여 리소스를 식별하고 범주화하십시오.  
*유형:* [태그](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html)의 목록  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[Tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-tags)` 속성으로 직접 전달됩니다.

`XrayEnabled`  <a name="sam-graphqlapi-xrayenabled"></a>
이 리소스에 대해 [AWS X-Ray 추적](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html)을 사용할지 여부를 표시하십시오.  
*유형*: 부울  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[XrayEnabled](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-xrayenabled)` 속성으로 직접 전달됩니다.

## 반환 값
<a name="sam-resource-graphqlapi-return-values"></a>

반환 값 목록은 [CloudFormation 사용 설명서](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)의 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#aws-resource-appsync-graphqlapi-return-values.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#aws-resource-appsync-graphqlapi-return-values.html)을(를) 참조하세요.

## 예제
<a name="sam-resource-graphqlapi-examples"></a>

### GraphQL APIDynamoDB 데이터 소스 사용
<a name="sam-resource-graphqlapi-examples-example1"></a>

이 예시에서는 DynamoDB 테이블을 데이터 소스로 사용하는 GraphQL API를 생성합니다.

**schema.graphql**

```
schema {
  query: Query
  mutation: Mutation
}

type Query {
  getPost(id: String!): Post
}

type Mutation {
  addPost(author: String!, title: String!, content: String!): Post!
}

type Post {
  id: String!
  author: String
  title: String
  content: String
  ups: Int!
  downs: Int!
  version: Int!
}
```

**template.yaml**

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  DynamoDBPostsTable:
    Type: AWS::Serverless::SimpleTable

  MyGraphQLAPI:
    Type: AWS::Serverless::GraphQLApi
    Properties:
      SchemaUri: ./sam_graphql_api/schema.graphql
      Auth:
        Type: AWS_IAM
      DataSources:
        DynamoDb:
          PostsDataSource:
            TableName: !Ref DynamoDBPostsTable
            TableArn: !GetAtt DynamoDBPostsTable.Arn
      Functions:
        preprocessPostItem:
          Runtime:
            Name: APPSYNC_JS
            Version: 1.0.0
          DataSource: NONE
          CodeUri: ./sam_graphql_api/preprocessPostItem.js
        createPostItem:
          Runtime:
            Name: APPSYNC_JS
            Version: "1.0.0"
          DataSource: PostsDataSource
          CodeUri: ./sam_graphql_api/createPostItem.js
        getPostFromTable:
          Runtime:
            Name: APPSYNC_JS
            Version: "1.0.0"
          DataSource: PostsDataSource
          CodeUri: ./sam_graphql_api/getPostFromTable.js
      Resolvers:
        Mutation:
          addPost:
            Runtime:
              Name: APPSYNC_JS
              Version: "1.0.0"
            Pipeline:
            - preprocessPostItem
            - createPostItem
        Query:
          getPost:
            CodeUri: ./sam_graphql_api/getPost.js
            Runtime:
              Name: APPSYNC_JS
              Version: "1.0.0"
            Pipeline:
            - getPostFromTable
```

**createPostItem.js**

```
import { util } from "@aws-appsync/utils";

export function request(ctx) {
  const { key, values } = ctx.prev.result;
  return {
    operation: "PutItem",
    key: util.dynamodb.toMapValues(key),
    attributeValues: util.dynamodb.toMapValues(values),
  };
}

export function response(ctx) {
  return ctx.result;
}
```

**getPostFromTable.js**

```
import { util } from "@aws-appsync/utils";

export function request(ctx) {
  return dynamoDBGetItemRequest({ id: ctx.args.id });
}

export function response(ctx) {
  return ctx.result;
}

/**
 * A helper function to get a DynamoDB item
 */
function dynamoDBGetItemRequest(key) {
  return {
    operation: "GetItem",
    key: util.dynamodb.toMapValues(key),
  };
}
```

**preprocessPostItem.js**

```
import { util } from "@aws-appsync/utils";

export function request(ctx) {
  const id = util.autoId();
  const { ...values } = ctx.args;
  values.ups = 1;
  values.downs = 0;
  values.version = 1;
  return { payload: { key: { id }, values: values } };
}

export function response(ctx) {
  return ctx.result;
}
```

해석기 코드는 다음과 같습니다.

**getPost.js**

```
export function request(ctx) {
  return {};
}

export function response(ctx) {
  return ctx.prev.result;
}
```

### GraphQLLambda 함수를 데이터 소스로 사용하는 API
<a name="sam-resource-graphqlapi-examples-example2"></a>

이 예시에서는 Lambda 함수를 데이터 소스로 사용하는 GraphQL API를 생성합니다.

**template.yaml**

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: index.handler
      Runtime: nodejs20.x
      CodeUri: ./lambda

  MyGraphQLAPI:
    Type: AWS::Serverless::GraphQLApi
    Properties:
      Name: MyApi
      SchemaUri: ./gql/schema.gql
      Auth:
        Type: API_KEY
      ApiKeys:
        MyApiKey:
          Description: my api key
      DataSources:
        Lambda:
          MyLambdaDataSource:
            FunctionArn: !GetAtt MyLambdaFunction.Arn
      Functions:
        lambdaInvoker:
          Runtime:
            Name: APPSYNC_JS
            Version: 1.0.0
          DataSource: MyLambdaDataSource
          CodeUri: ./gql/invoker.js
      Resolvers:
        Mutation:
          addPost:
            Runtime:
              Name: APPSYNC_JS
              Version: 1.0.0
            Pipeline:
            - lambdaInvoker
        Query:
          getPost:
            Runtime:
              Name: APPSYNC_JS
              Version: 1.0.0
            Pipeline:
            - lambdaInvoker

Outputs:
  MyGraphQLAPI:
    Description: AppSync API
    Value: !GetAtt MyGraphQLAPI.GraphQLUrl
  MyGraphQLAPIMyApiKey:
    Description: API Key for authentication
    Value: !GetAtt MyGraphQLAPIMyApiKey.ApiKey
```

**schema.graphql**

```
schema {
  query: Query
  mutation: Mutation
}
type Query {
  getPost(id: ID!): Post
}
type Mutation {
  addPost(id: ID!, author: String!, title: String, content: String): Post!
}
type Post {
  id: ID!
  author: String!
  title: String
  content: String
  ups: Int
  downs: Int
}
```

함수는 다음과 같습니다.

**lambda/index.js**

```
exports.handler = async (event) => {
  console.log("Received event {}", JSON.stringify(event, 3));

  const posts = {
    1: {
      id: "1",
      title: "First book",
      author: "Author1",
      content: "Book 1 has this content",
      ups: "100",
      downs: "10",
    },
  };

  console.log("Got an Invoke Request.");
  let result;
  switch (event.field) {
    case "getPost":
      return posts[event.arguments.id];
    case "addPost":
      // return the arguments back
      return event.arguments;
    default:
      throw new Error("Unknown field, unable to resolve " + event.field);
  }
};
```

**invoker.js**

```
import { util } from "@aws-appsync/utils";

export function request(ctx) {
  const { source, args } = ctx;
  return {
    operation: "Invoke",
    payload: { field: ctx.info.fieldName, arguments: args, source },
  };
}

export function response(ctx) {
  return ctx.result;
}
```

# ApiKeys
<a name="sam-property-graphqlapi-apikeys"></a>

API 키가 필요한 GraphQL 작업을 수행하는 데 사용할 수 있는 고유 키를 생성합니다.

## 구문
<a name="sam-property-graphqlapi-apikeys-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-apikeys-syntax-yaml"></a>

```
LogicalId:
  ApiKeyId: String
  Description: String
  ExpiresOn: Double
```

## 속성
<a name="sam-property-graphqlapi-apikeys-properties"></a>

`ApiKeyId`  <a name="sam-graphqlapi-apikeys-apikeyid"></a>
귀하의 API 키의 고유한 이름. `LogicalId` 값을 재정의하도록 지정합니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::ApiKey` 리소스의 `[ApiKeyId](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apikey.html#cfn-appsync-apikey-apikeyid)` 속성으로 직접 전달됩니다.

`Description`  <a name="sam-graphqlapi-apikeys-description"></a>
귀하의 API 키의 고유한 설명.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::ApiKey` 리소스의 `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apikey.html#cfn-appsync-apikey-description)` 속성으로 직접 전달됩니다.

`ExpiresOn`  <a name="sam-graphqlapi-apikeys-expireson"></a>
API 키가 만료되는 시간입니다. 날짜는 Epoch 이후 경과한 초로 표시되며 가장 가까운 시간으로 반올림됩니다.  
*유형*: Double  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::ApiKey` 리소스의 `[Expires](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apikey.html#cfn-appsync-apikey-expires)` 속성으로 직접 전달됩니다.

`LogicalId`  <a name="sam-graphqlapi-apikeys-logicalid"></a>
귀하의 API 키의 고유한 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::ApiKey` 리소스의 `[ApiKeyId](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apikey.html#cfn-appsync-apikey-apikeyid)` 속성으로 직접 전달됩니다.

# Auth
<a name="sam-property-graphqlapi-auth"></a>

귀하의 GraphQL API에 대한 권한 부여를 구성합니다.

## 구문
<a name="sam-property-graphqlapi-auth-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-auth-syntax-yaml"></a>

```
Additional:
- AuthProvider
LambdaAuthorizer: [LambdaAuthorizerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-lambdaauthorizerconfig.html)
OpenIDConnect: [OpenIDConnectConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-openidconnectconfig.html)
Type: String
UserPool: [UserPoolConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-userpoolconfig.html)
```

## 속성
<a name="sam-property-graphqlapi-auth-properties"></a>

`Additional`  <a name="sam-graphqlapi-auth-additional"></a>
귀하의 GraphQLAPI에 대한 추가 인증 유형 목록.  
*유형*: [AuthProvider](sam-property-graphqlapi-auth-authprovider.md) 목록  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 동등한 속성이 CloudFormation 없습니다.

`LambdaAuthorizer`  <a name="sam-graphqlapi-auth-lambdaauthorizer"></a>
Lambda 함수 권한 부여자에 대한 선택적 권한 부여 구성을 지정합니다. `Type`이 `AWS_LAMBDA`로 지정된 경우 이 선택적 속성을 구성할 수 있습니다.  
*유형*: [LambdaAuthorizerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-lambdaauthorizerconfig)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[ LambdaAuthorizerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-lambdaauthorizerconfig.html)` 속성으로 직접 전달됩니다.

`OpenIDConnect`  <a name="sam-graphqlapi-auth-openidconnect"></a>
귀하의 OpenID Connect 규정 준수 서비스를 위한 선택적 권한 부여 구성을 지정합니다. `Type`이 `OPENID_CONNECT`로 지정된 경우 이 선택적 속성을 구성할 수 있습니다.  
*유형*: [OpenIDConnectConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-openidconnectconfig)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[ OpenIDConnectConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-openidconnectconfig.html)` 속성으로 직접 전달됩니다.

`Type`  <a name="sam-graphqlapi-auth-type"></a>
애플리케이션과 API 간의 기본 권한 부여 유형입니다 AWS AppSync GraphQL.  
허용된 값의 목록과 설명은 *AWS AppSync 개발자 안내서*의 [권한 부여 및 인증을](https://docs.aws.amazon.com/appsync/latest/devguide/security-authz.html) 참조하세요.  
Lambda 권한 부여자(`AWS_LAMBDA`)를 지정하면 GraphQL는 API와 Lambda 함수 간에 권한을 프로비저닝하는 AWS Identity and Access Management (IAM) 정책을 AWS SAM 생성합니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[AuthenticationType](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-authenticationtype)` 속성으로 직접 전달됩니다.

`UserPool`  <a name="sam-graphqlapi-auth-userpool"></a>
Amazon Cognito 사용자 풀을 사용하기 위한 선택적 권한 부여 구성을 지정합니다. `Type`이 `AMAZON_COGNITO_USER_POOLS`로 지정된 경우 이 선택적 속성을 구성할 수 있습니다.  
*유형*: [UserPoolConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-userpoolconfig)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` 리소스의 `[ UserPoolConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-userpoolconfig.html)` 속성으로 직접 전달됩니다.

## 예제
<a name="sam-property-graphqlapi-auth-examples"></a>

### 기본 및 추가 권한 부여 유형을 구성합니다.
<a name="sam-property-graphqlapi-auth-examples-example1"></a>

이 예시에서는 먼저 Lambda 권한 부여자를 GraphQL API의 기본 권한 부여 유형으로 구성합니다. 

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyGraphQLAPI:
    Type: AWS::Serverless::GraphQLApi
    Properties:
      Auth:
        Type: AWS_LAMBDA
        LambdaAuthorizer:
          AuthorizerUri: !GetAtt Authorizer1.Arn
          AuthorizerResultTtlInSeconds: 10
          IdentityValidationExpression: hello
```

다음으로 AWS SAM 템플릿에 다음을 추가하여 GraphQL API에 대한 추가 권한 부여 유형을 구성합니다. 

```
        Additional:
        - Type: AWS_IAM
        - Type: API_KEY
        - Type: OPENID_CONNECT
          OpenIDConnect:
            AuthTTL: 10
            ClientId: myId
            IatTTL: 10
            Issuer: prod
```

그러면 다음 AWS SAM 템플릿이 생성됩니다.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyGraphQLAPI:
    Type: AWS::Serverless::GraphQLApi
    Properties:
      Auth:
        Type: AWS_LAMBDA
        LambdaAuthorizer:
          AuthorizerUri: !GetAtt Authorizer1.Arn
          AuthorizerResultTtlInSeconds: 10
          IdentityValidationExpression: hello
        Additional:
        - Type: AWS_IAM
        - Type: API_KEY
        - Type: OPENID_CONNECT
          OpenIDConnect:
            AuthTTL: 10
            ClientId: myId
            IatTTL: 10
            Issuer: prod
```

# AuthProvider
<a name="sam-property-graphqlapi-auth-authprovider"></a>

귀하의 추가적인 GraphQL API 권한 부여 유형을 위한 선택적 권한 부여 구성.

## 구문
<a name="sam-property-graphqlapi-auth-authprovider-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-auth-authprovider-syntax-yaml"></a>

```
LambdaAuthorizer: [LambdaAuthorizerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-lambdaauthorizerconfig.html)
OpenIDConnect: [OpenIDConnectConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-openidconnectconfig.html)
Type: String
UserPool: [UserPoolConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-userpoolconfig.html)
```

## 속성
<a name="sam-property-graphqlapi-auth-authprovider-properties"></a>

`LambdaAuthorizer`  <a name="sam-graphqlapi-auth-authprovider-lambdaauthorizer"></a>
 AWS Lambda 함수 권한 부여자에 대한 선택적 권한 부여 구성을 지정합니다. `Type`이 `AWS_LAMBDA`로 지정된 경우 이 선택적 속성을 구성할 수 있습니다.  
*유형*: [LambdaAuthorizerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-lambdaauthorizerconfig)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` `[ AdditionalAuthenticationProvider](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-additionalauthenticationprovider.html)` 객체의 `[ LambdaAuthorizerConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-lambdaauthorizerconfig.html)` 속성으로 직접 전달됩니다.

`OpenIDConnect`  <a name="sam-graphqlapi-auth-authprovider-openidconnect"></a>
귀하의 OpenID Connect 규정 준수 서비스를 위한 선택적 권한 부여 구성을 지정합니다. `Type`이 `OPENID_CONNECT`로 지정된 경우 이 선택적 속성을 구성할 수 있습니다.  
*유형*: [OpenIDConnectConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-openidconnectconfig)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` `[ AdditionalAuthenticationProvider](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-additionalauthenticationprovider.html)` 객체의 `[ OpenIDConnectConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-openidconnectconfig.html)` 속성으로 직접 전달됩니다.

`Type`  <a name="sam-graphqlapi-auth-authprovider-type"></a>
애플리케이션과 API 간의 기본 권한 부여 유형입니다 AWS AppSync GraphQL.  
허용된 값의 목록과 설명은 *AWS AppSync 개발자 안내서*의 [권한 부여 및 인증을](https://docs.aws.amazon.com/appsync/latest/devguide/security-authz.html) 참조하세요.  
Lambda 권한 부여자(`AWS_LAMBDA`)를 지정하면 GraphQL는 API와 Lambda 함수 간에 권한을 프로비저닝하는 AWS Identity and Access Management (IAM) 정책을 AWS SAM 생성합니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` `[ AdditionalAuthenticationProvider](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-additionalauthenticationprovider.html)` 객체의 `[ AuthenticationType](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-additionalauthenticationprovider.html#cfn-appsync-graphqlapi-additionalauthenticationprovider-authenticationtype)` 속성으로 직접 전달됩니다.

`UserPool`  <a name="sam-graphqlapi-auth-authprovider-userpool"></a>
Amazon Cognito 사용자 풀을 사용하기 위한 선택적 권한 부여 구성을 지정합니다. `Type`이 `AMAZON_COGNITO_USER_POOLS`로 지정된 경우 이 선택적 속성을 구성할 수 있습니다.  
*유형*: [UserPoolConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-graphqlapi.html#cfn-appsync-graphqlapi-userpoolconfig)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::GraphQLApi` `[ AdditionalAuthenticationProvider](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-additionalauthenticationprovider.html)` 객체의 `[ UserPoolConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-graphqlapi-userpoolconfig.html)` 속성으로 직접 전달됩니다.

# 데이터 소스
<a name="sam-property-graphqlapi-datasource"></a>

GraphQL API 해석기가 연결할 수 있는 데이터 소스를 구성하십시오. AWS Serverless Application Model (AWS SAM) 템플릿을 사용하여 다음 데이터 소스에 대한 연결을 구성할 수 있습니다.
+ Amazon DynamoDB
+ AWS Lambda

데이터 소스에 대해 자세히 알아보려면 *AWS AppSync 개발자 안내서*의 [데이터 소스 연결](https://docs.aws.amazon.com/appsync/latest/devguide/attaching-a-data-source.html)을 참조하세요.

## 구문
<a name="sam-property-graphqlapi-datasource-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-datasource-syntax-yaml"></a>

```
DynamoDb: DynamoDb
Lambda: Lambda
```

## 속성
<a name="sam-property-graphqlapi-datasource-properties"></a>

`DynamoDb`  <a name="sam-graphqlapi-datasource-dynamodb"></a>
DynamoDB 테이블을 GraphQL API 해석기의 데이터 소스로 구성합니다.  
*유형*: [DynamoDB](sam-property-graphqlapi-datasource-dynamodb.md)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`Lambda`  <a name="sam-graphqlapi-datasource-lambda"></a>
Lambda 함수를 귀하의 GraphQL API 해석기의 데이터 소스로 구성합니다.  
*유형*: [Lambda](sam-property-graphqlapi-datasource-lambda.md)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

# DynamoDb
<a name="sam-property-graphqlapi-datasource-dynamodb"></a>

Amazon DynamoDB 테이블을 귀하의 GraphQLAPI 해석기의 데이터 소스로 구성합니다. 

## 구문
<a name="sam-property-graphqlapi-datasource-dynamodb-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-datasource-dynamodb-syntax-yaml"></a>

```
LogicalId:
  DeltaSync: [DeltaSyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-deltasyncconfig.html)
  Description: String
  Name: String
  Permissions: List
  Region: String
  ServiceRoleArn: String
  TableArn: String
  TableName: String
  UseCallerCredentials: Boolean
  Versioned: Boolean
```

## 속성
<a name="sam-property-graphqlapi-datasource-dynamodb-properties"></a>

`DeltaSync`  <a name="sam-graphqlapi-datasource-dynamodb-deltasync"></a>
델타 동기화 구성에 대해 설명합니다.  
*유형*: [DeltaSyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-deltasyncconfig.html)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[DeltaSyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-deltasyncconfig)` 속성으로 직접 전달됩니다.

`Description`  <a name="sam-graphqlapi-datasource-dynamodb-description"></a>
귀하의 데이터 소스에 대한 설명.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-description)` 속성으로 직접 전달됩니다.

`LogicalId`  <a name="sam-graphqlapi-datasource-dynamodb-logicalid"></a>
귀하의 데이터 소스의 고유한 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-name)` 속성으로 직접 전달됩니다.

`Name`  <a name="sam-graphqlapi-datasource-dynamodb-name"></a>
귀하의 데이터 소스의 이름. 이 속성을 지정하여 `LogicalId` 값을 재정의합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-name)` 속성으로 직접 전달됩니다.

`Permissions`  <a name="sam-graphqlapi-datasource-dynamodb-permissions"></a>
[AWS SAM 커넥터](managing-permissions-connectors.md)를 사용하여 데이터 소스에 권한을 제공합니다. 다음 값 중 하나를 목록에 제공할 수 있습니다.  
+ `Read` – 귀하의 리졸버가 데이터 소스를 읽을 수 있도록 허용합니다.
+ `Write` – 귀하의 리졸버가 데이터 소스에 쓸 수 있도록 허용합니다.
AWS SAM 는 배포 시 변환된 `AWS::Serverless::Connector` 리소스를 사용하여 권한을 프로비저닝합니다. 생성된 리소스에 대한 자세한 내용은을 참조하세요[CloudFormation 지정할 때 생성된 리소스 AWS::Serverless::Connector](sam-specification-generated-resources-connector.md).  
`Permissions` 또는 `ServiceRoleArn`을 지정할 수 있지만 둘 다 함께 지정할 수는 없습니다. 둘 다 지정하지 않으면 AWS SAM 는 `Read` 및의 기본값을 생성합니다`Write`. 데이터 소스에 대한 액세스를 취소하려면 AWS SAM 템플릿에서 DynamoDB 객체를 제거합니다.
*유형*: 목록  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다. 이것은 `AWS::Serverless::Connector` 리소스의 `Permissions` 속성과 유사합니다.

`Region`  <a name="sam-graphqlapi-datasource-dynamodb-region"></a>
DynamoDB 테이블 AWS 리전 의 입니다. 지정하지 않으면에서를 AWS SAM 사용합니다`[AWS::Region](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/pseudo-parameter-reference.html#cfn-pseudo-param-region)`.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[AwsRegion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-awsregion)` 속성으로 직접 전달됩니다.

`ServiceRoleArn`  <a name="sam-graphqlapi-datasource-dynamodb-servicerolearn"></a>
데이터 소스에 대한 AWS Identity and Access Management (IAM) 서비스 역할 ARN입니다. 시스템은 데이터 소스에 액세스할 때 이 역할을 사용합니다.  
`Permissions` 또는 `ServiceRoleArn`을 지정할 수 있지만 둘 다 함께 지정할 수는 없습니다.  
*유형*: 문자열  
*필수*: 아니요. 지정하지 않으면의 기본값을 AWS SAM 적용합니다`Permissions`.  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[ServiceRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-servicerolearn)` 속성으로 직접 전달됩니다.

`TableArn`  <a name="sam-graphqlapi-datasource-dynamodb-tablearn"></a>
DynamoDB 테이블의 ARN.  
*유형*: 문자열  
*필수 항목 여부*: 조건부. `ServiceRoleArn`를 지정하지 않는 경우 `TableArn`가 필수입니다.  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`TableName`  <a name="sam-graphqlapi-datasource-dynamodb-tablename"></a>
테이블 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[TableName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-tablename)` 속성으로 직접 전달됩니다.

`UseCallerCredentials`  <a name="sam-graphqlapi-datasource-dynamodb-usecallercredentials"></a>
이 데이터 소스로 IAM을 사용하려면 `true`로 설정합니다.  
*유형*: 부울  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[UseCallerCredentials](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-usecallercredentials)` 속성으로 직접 전달됩니다.

`Versioned`  <a name="sam-graphqlapi-datasource-dynamodb-versioned"></a>
이 데이터 소스로 [충돌 감지 및 충돌 해결 및 동기화](https://docs.aws.amazon.com/appsync/latest/devguide/conflict-detection-and-sync.html)를 사용하려면 `true`로 설정합니다.  
*유형*: 부울  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource DynamoDBConfig` 객체의 `[Versioned](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-dynamodbconfig.html#cfn-appsync-datasource-dynamodbconfig-versioned)` 속성으로 직접 전달됩니다.

# Lambda
<a name="sam-property-graphqlapi-datasource-lambda"></a>

 AWS Lambda 함수를 GraphQL API 해석기의 데이터 소스로 구성합니다.

## 구문
<a name="sam-property-graphqlapi-datasource-lambda-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-datasource-lambda-syntax-yaml"></a>

```
LogicalId:
  Description: String
  FunctionArn: String
  Name: String
  ServiceRoleArn: String
```

## 속성
<a name="sam-property-graphqlapi-datasource-lambda-properties"></a>

`Description`  <a name="sam-graphqlapi-datasource-lambda-description"></a>
귀하의 데이터 소스에 대한 설명.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-description)` 속성으로 직접 전달됩니다.

`FunctionArn`  <a name="sam-graphqlapi-datasource-lambda-functionarn"></a>
Lambda 함수의 ARN입니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource LambdaConfig` 객체의 `[LambdaFunctionArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-datasource-lambdaconfig.html#cfn-appsync-datasource-lambdaconfig-lambdafunctionarn)` 속성으로 직접 전달됩니다.

`LogicalId`  <a name="sam-graphqlapi-datasource-lambda-logicalid"></a>
귀하의 데이터 소스의 고유한 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-name)` 속성으로 직접 전달됩니다.

`Name`  <a name="sam-graphqlapi-datasource-lambda-name"></a>
귀하의 데이터 소스의 이름. 이 속성을 지정하여 `LogicalId` 값을 재정의합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-name)` 속성으로 직접 전달됩니다.

`ServiceRoleArn`  <a name="sam-graphqlapi-datasource-lambda-servicerolearn"></a>
데이터 소스에 대한 AWS Identity and Access Management (IAM) 서비스 역할 ARN입니다. 시스템은 데이터 소스에 액세스할 때 이 역할을 사용합니다.  
데이터 소스에 대한 액세스 권한을 취소하려면 귀하의 AWS SAM 템플릿에서 Lambda 객체를 제거하십시오. 
*유형*: 문자열  
*필수*: 아니요. 지정하지 않으면 AWS SAM 가를 사용하여 `Write` 권한을 프로비저닝합니다[AWS SAM 커넥터](managing-permissions-connectors.md).  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::DataSource` 리소스의 `[ServiceRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-servicerolearn)` 속성으로 직접 전달됩니다.

# 함수
<a name="sam-property-graphqlapi-function"></a>

특정 작업을 수행하도록 GraphQL API의 함수를 구성합니다.

## 구문
<a name="sam-property-graphqlapi-function-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-function-syntax-yaml"></a>

```
LogicalId:
  CodeUri: String
  DataSource: String
  Description: String
  Id: String
  InlineCode: String
  MaxBatchSize: Integer
  Name: String
  Runtime: Runtime
  Sync: [SyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-functionconfiguration-syncconfig.html)
```

## 속성
<a name="sam-property-graphqlapi-function-properties"></a>

`CodeUri`  <a name="sam-graphqlapi-function-codeuri"></a>
함수 코드의 Amazon Simple Storage Service(S3) URI 또는 로컬 폴더 경로.  
로컬 폴더의 경로를 지정하는 경우 배포 전에 파일을 먼저 Amazon S3에 업로드해야 CloudFormation 합니다. AWS SAMCLI를 사용하여 이 프로세스를 용이하게 할 수 있습니다. 자세한 내용은 [가 배포 시 로컬 파일을 AWS SAM 업로드하는 방법](deploy-upload-local-files.md)을 참조하십시오  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration` 리소스의 `[CodeS3Location](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-codes3location)` 속성으로 직접 전달됩니다.

`DataSource`  <a name="sam-graphqlapi-function-datasource"></a>
이 함수가 연결되는 데이터 원본의 이름입니다.  
+ `AWS::Serverless::GraphQLApi` 리소스 내 데이터 소스를 참조하려면 해당 데이터 소스의 논리적 ID를 지정합니다.
+ `AWS::Serverless::GraphQLApi` 리소스 외부의 데이터 소스를 참조하려면 `Fn::GetAtt` 내장 함수를 사용하여 해당 `Name` 속성을 제공합니다. 예를 들어 `!GetAtt MyLambdaDataSource.Name`입니다.
+ 다른 스택의 데이터 소스를 참조하려면 `[Fn::ImportValue](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html)`를 사용합니다.
변형을 지정하면 `[NONE | None | none]`가 `AWS::AppSync::DataSource` `[Type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-datasource.html#cfn-appsync-datasource-type)` 객체에 대한 `None` 값을 AWS SAM 생성합니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration` 리소스의 `[DataSourceName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-datasourcename)` 속성으로 직접 전달됩니다.

`Description`  <a name="sam-graphqlapi-function-description"></a>
함수에 대한 설명.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration` 리소스의 `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-description)` 속성으로 직접 전달됩니다.

`Id`  <a name="sam-graphqlapi-function-id"></a>
`AWS::Serverless::GraphQLApi` 리소스 외부에 있는 함수의 함수 ID입니다.  
+ 동일한 AWS SAM 템플릿 내에서 함수를 참조하려면 `Fn::GetAtt` 내장 함수를 사용합니다. 예: `Id: !GetAtt createPostItemFunc.FunctionId`.
+ 다른 스택의 함수를 참조하려면 `[Fn::ImportValue](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html)`를 사용합니다.
`Id`를 사용하는 경우 다른 모든 속성은 허용되지 않습니다. AWS SAM 는 참조된 함수의 함수 ID를 자동으로 전달합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`InlineCode`  <a name="sam-graphqlapi-function-inlinecode"></a>
요청 및 응답 함수가 포함된 코드입니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration` 리소스의 `[Code](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-code)` 속성으로 직접 전달됩니다.

`LogicalId`  <a name="sam-graphqlapi-function-logicalid"></a>
함수의 고유한 이름.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-name)` 속성으로 직접 전달됩니다.

`MaxBatchSize`  <a name="sam-graphqlapi-function-maxbatchsize"></a>
`BatchInvoke` 작업에서 단일 AWS Lambda 함수에 보낼 최대 해석기 요청 입력 수입니다.  
*유형*: 정수  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration` 리소스의 [MaxBatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-maxbatchsize) 속성으로 직접 전달됩니다.

`Name`  <a name="sam-graphqlapi-function-name"></a>
함수의 이름입니다. `LogicalId` 값을 재정의하도록 지정합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-name)` 속성으로 직접 전달됩니다.

`Runtime`  <a name="sam-graphqlapi-function-runtime"></a>
 AWS AppSync 파이프라인 해석기 또는 AWS AppSync 함수에서 사용하는 런타임을 설명합니다. 사용할 런타임의 이름과 버전을 지정합니다.  
*유형*: [런타임](sam-property-graphqlapi-function-runtime.md)  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다. 이것은 `[Runtime](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-runtime)` 리소스의 `AWS::AppSync::FunctionConfiguration` 속성과 유사합니다.

`Sync`  <a name="sam-graphqlapi-function-sync"></a>
해석기에 대한 동기화 구성에 대해 설명합니다.  
해석기가 호출될 때 사용할 충돌 감지 전략과 해결 전략을 지정합니다.  
*유형*: [SyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-functionconfiguration-syncconfig.html)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration` 리소스의 `[SyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-functionconfiguration.html#cfn-appsync-functionconfiguration-syncconfig)` 속성으로 직접 전달됩니다.

# 런타임
<a name="sam-property-graphqlapi-function-runtime"></a>

파이프라인 해석기 또는 함수의 런타임 사용할 런타임의 이름과 버전을 지정합니다.

## 구문
<a name="sam-property-graphqlapi-function-runtime-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-function-runtime-syntax-yaml"></a>

```
Name: String
Version: String
```

## 속성
<a name="sam-property-graphqlapi-function-runtime-properties"></a>

`Name`  <a name="sam-graphqlapi-function-runtime-name"></a>
사용할 런타임의 이름. 현재, 유일하게 허용되는 값은 `APPSYNC_JS`입니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration AppSyncRuntime` 객체의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-functionconfiguration-appsyncruntime.html#cfn-appsync-functionconfiguration-appsyncruntime-name)` 속성으로 직접 전달됩니다.

`Version`  <a name="sam-graphqlapi-function-runtime-version"></a>
사용할 런타임의 버전. 현재 유일하게 허용되는 버전은 `1.0.0`입니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::FunctionConfiguration AppSyncRuntime` 객체의 `[RuntimeVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-functionconfiguration-appsyncruntime.html#cfn-appsync-functionconfiguration-appsyncruntime-runtimeversion)` 속성으로 직접 전달됩니다.

# 해석기
<a name="sam-property-graphqlapi-resolver"></a>

GraphQL API의 필드에 대한 해석기를 구성합니다. AWS Serverless Application Model (AWS SAM)는 [JavaScript 파이프라인 해석기를](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-overview-js.html) 지원합니다.

## 구문
<a name="sam-property-graphqlapi-resolver-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-resolver-syntax-yaml"></a>

```
OperationType:
  LogicalId:
    Caching: [CachingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-resolver-cachingconfig.html)
    CodeUri: String
    FieldName: String
    InlineCode: String 
    MaxBatchSize: Integer
    Pipeline: List
    Runtime: Runtime
    Sync: [SyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-resolver-syncconfig.html)
```

## 속성
<a name="sam-property-graphqlapi-resolver-properties"></a>

`Caching`  <a name="sam-graphqlapi-resolver-caching"></a>
캐싱이 활성화된 해석기에 대한 캐싱 구성입니다.  
*Type*: [CachingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-resolver-cachingconfig.html)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver` 리소스의 `[CachingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-cachingconfig)` 속성으로 직접 전달됩니다.

`CodeUri`  <a name="sam-graphqlapi-resolver-codeuri"></a>
해석기 함수 코드의 Amazon Simple Storage Service(S3) URI 또는 로컬 폴더 경로.  
로컬 폴더의 경로를 지정하는 경우 배포 전에 파일을 먼저 Amazon S3에 업로드해야 CloudFormation 합니다. AWS SAMCLI를 사용하여 이 프로세스를 용이하게 할 수 있습니다. 자세한 내용은 [가 배포 시 로컬 파일을 AWS SAM 업로드하는 방법](deploy-upload-local-files.md) 단원을 참조하십시오.  
`CodeUri` 또는이 제공되지 않은 경우 `InlineCode`는 요청을 첫 번째 파이프라인 함수로 `InlineCode`리디렉션하고 마지막 파이프라인 함수로부터 응답을 수신하는를 AWS SAM 생성합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver` 리소스의 `[CodeS3Location](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-codes3location)` 속성으로 직접 전달됩니다.

`FieldName`  <a name="sam-graphqlapi-resolver-fieldname"></a>
해석기의 이름. 이 속성을 지정하여 `LogicalId` 값을 재정의합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver` 리소스의 `[FieldName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-fieldname)` 속성으로 직접 전달됩니다.

`InlineCode`  <a name="sam-graphqlapi-resolver-inlinecode"></a>
요청 및 응답 함수가 포함된 해석기 코드입니다.  
`CodeUri` 또는이 제공되지 않은 경우 `InlineCode`는 요청을 첫 번째 파이프라인 함수로 `InlineCode`리디렉션하고 마지막 파이프라인 함수로부터 응답을 수신하는를 AWS SAM 생성합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver` 리소스의 `[Code](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-code)` 속성으로 직접 전달됩니다.

`LogicalId`  <a name="sam-graphqlapi-resolver-logicalid"></a>
해석기의 고유 이름입니다. GraphQL 스키마에서 해석기 이름은 사용된 필드 이름과 일치해야 합니다. `LogicalId`에 같은 필드 이름을 사용합니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

`MaxBatchSize`  <a name="sam-graphqlapi-resolver-maxbatchsize"></a>
`BatchInvoke` 작업에서 단일 AWS Lambda 함수에 보낼 최대 해석기 요청 입력 수입니다.  
*유형*: 정수  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver` 리소스의 `[MaxBatchSize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-maxbatchsize)` 속성으로 직접 전달됩니다.

`OperationType`  <a name="sam-graphqlapi-resolver-operationtype"></a>
해석기와 관련된 GraphQL 작업 유형입니다. 예: `Query`, `Mutation` 또는 `Subscription`. 단일 `OperationType` 내에 `LogicalId`으로 여러 개의 해석기를 중첩할 수 있습니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver` 리소스의 `[TypeName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-typename)` 속성으로 직접 전달됩니다.

`Pipeline`  <a name="sam-graphqlapi-resolver-pipeline"></a>
파이프라인 해석기와 연결된 함수. 목록에서 논리적 ID로 함수를 지정합니다.  
*유형*: 목록  
*필수 항목 여부*: 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다. 이것은 `[PipelineConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-pipelineconfig)` 리소스의 `AWS::AppSync::Resolver` 속성과 유사합니다.

`Runtime`  <a name="sam-graphqlapi-resolver-runtime"></a>
파이프라인 해석기 또는 함수의 런타임 사용할 런타임의 이름과 버전을 지정합니다.  
*유형*: [런타임](sam-property-graphqlapi-resolver-runtime.md)  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다. 이것은 `[Runtime](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-runtime)` 리소스의 `AWS::AppSync::Resolver` 속성과 유사합니다.

`Sync`  <a name="sam-graphqlapi-resolver-sync"></a>
해석기에 대한 동기화 구성에 대해 설명합니다.  
해석기가 호출될 때 사용할 충돌 감지 전략과 해결 전략을 지정합니다.  
*유형*: [SyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-resolver-syncconfig.html)  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver` 리소스의 `[SyncConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-resolver.html#cfn-appsync-resolver-syncconfig)` 속성으로 직접 전달됩니다.

## 예제
<a name="sam-property-graphqlapi-resolver-examples"></a>

### AWS SAM 생성된 해석기 함수 코드를 사용하고 필드를 변수로 저장
<a name="sam-property-graphqlapi-resolver-examples-example1"></a>

예제의 GraphQL 스키마는 다음과 같습니다.

```
schema {
  query: Query
  mutation: Mutation
}

type Query {
  getPost(id: ID!): Post
}

type Mutation {
  addPost(author: String!, title: String!, content: String!): Post!
}

type Post {
  id: ID!
  author: String
  title: String
  content: String
}
```

다음은 AWS SAM 템플릿의 코드 조각입니다.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyGraphQLApi:
    Type: AWS::Serverless::GraphQLApi
    Properties:
      ...
      Functions:
        preprocessPostItem:
          ...
        createPostItem:
          ...
      Resolvers:
        Mutation:
          addPost:
            Runtime:
              Name: APPSYNC_JS
              Version: 1.0.0
            Pipeline:
            - preprocessPostItem
            - createPostItem
```

 AWS SAM 템플릿에서는 `CodeUri` 또는를 지정하지 않습니다`InlineCode`. 배포 시는 해석기에 대해 다음과 같은 인라인 코드를 AWS SAM 자동으로 생성합니다.

```
export function request(ctx) {
  return {};
}

export function response(ctx) {
  return ctx.prev.result;
}
```

이 디폴트 해석기 코드는 요청을 첫 번째 파이프라인 함수로 리디렉션하고 마지막 파이프라인 함수로부터 응답을 받습니다.

첫 번째 파이프라인 함수에서는 제공된 `args` 필드를 사용하여 요청 객체를 파싱하고 변수를 생성할 수 있습니다. 그러면 함수 내에서 이러한 변수를 사용할 수 있습니다. 다음은 `preprocessPostItem` 함수의 예입니다.

```
import { util } from "@aws-appsync/utils";

export function request(ctx) {
  const author = ctx.args.author;
  const title = ctx.args.title;
  const content = ctx.args.content;
  
  // Use variables to process data
  
}

export function response(ctx) {
  return ctx.result;
}
```

# 런타임
<a name="sam-property-graphqlapi-resolver-runtime"></a>

파이프라인 해석기 또는 함수의 런타임 사용할 런타임의 이름과 버전을 지정합니다.

## 구문
<a name="sam-property-graphqlapi-resolver-runtime-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-graphqlapi-resolver-runtime-syntax-yaml"></a>

```
Name: String
Version: String
```

## 속성
<a name="sam-property-graphqlapi-resolver-runtime-properties"></a>

`Name`  <a name="sam-graphqlapi-resolver-runtime-name"></a>
사용할 런타임의 이름. 현재, 유일하게 허용되는 값은 `APPSYNC_JS`입니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver AppSyncRuntime` 객체의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-resolver-appsyncruntime.html#cfn-appsync-resolver-appsyncruntime-name)` 속성으로 직접 전달됩니다.

`Version`  <a name="sam-graphqlapi-resolver-runtime-version"></a>
사용할 런타임의 버전. 현재 유일하게 허용되는 버전은 `1.0.0`입니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::AppSync::Resolver AppSyncRuntime` 객체의 `[RuntimeVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-resolver-appsyncruntime.html#cfn-appsync-resolver-appsyncruntime-runtimeversion)` 속성으로 직접 전달됩니다.