"documentation":"<p>Creates a <code>Resolver</code> object.</p> <p>A resolver converts incoming requests into a format that a data source can understand and converts the data source's responses into GraphQL.</p>"
},
"CreateType":{
"name":"CreateType",
"http":{
"method":"POST",
"requestUri":"/v1/apis/{apiId}/types"
},
"input":{"shape":"CreateTypeRequest"},
"output":{"shape":"CreateTypeResponse"},
"errors":[
{"shape":"BadRequestException"},
{"shape":"ConcurrentModificationException"},
{"shape":"NotFoundException"},
{"shape":"UnauthorizedException"},
{"shape":"InternalFailureException"}
],
"documentation":"<p>Creates a <code>Type</code> object.</p>"
"documentation":"<p>Lists the API keys for a given API.</p> <note> <p>API keys are deleted automatically sometime after they expire. However, they may still be included in the response until they have actually been deleted. You can safely call <code>DeleteApiKey</code> to manually delete a key before it's automatically deleted.</p> </note>"
"documentation":"<p>The time after which the API key expires. The date is represented as seconds since the epoch, rounded down to the nearest hour.</p>"
"documentation":"<p>Describes an API key.</p> <p>Customers invoke AWS AppSync GraphQL APIs with API keys as an identity mechanism. There are two key versions:</p> <p> <b>da1</b>: This version was introduced at launch in November 2017. These keys always expire after 7 days. Key expiration is managed by DynamoDB TTL. The keys will cease to be valid after Feb 21, 2018 and should not be used after that date.</p> <ul> <li> <p> <code>ListApiKeys</code> returns the expiration time in milliseconds.</p> </li> <li> <p> <code>CreateApiKey</code> returns the expiration time in milliseconds.</p> </li> <li> <p> <code>UpdateApiKey</code> is not available for this key version.</p> </li> <li> <p> <code>DeleteApiKey</code> deletes the item from the table.</p> </li> <li> <p>Expiration is stored in DynamoDB as milliseconds. This results in a bug where keys are not automatically deleted because DynamoDB expects the TTL to be stored in seconds. As a one-time action, we will delete these keys from the table after Feb 21, 2018.</p> </li> </ul> <p> <b>da2</b>: This version was introduced in February 2018 when AppSync added support to extend key expiration.</p> <ul> <li> <p> <code>ListApiKeys</code> returns the expiration time in seconds.</p> </li> <li> <p> <code>CreateApiKey</code> returns the expiration time in seconds and accepts a user-provided expiration time in seconds.</p> </li> <li> <p> <code>UpdateApiKey</code> returns the expiration time in seconds and accepts a user-provided expiration time in seconds. Key expiration can only be updated while the key has not expired.</p> </li> <li> <p> <code>DeleteApiKey</code> deletes the item from the table.</p> </li> <li> <p>Expiration is stored in DynamoDB as seconds.</p> </li> </ul>"
"documentation":"<p>The API key expiration must be set to a value between 1 and 365 days from creation (for <code>CreateApiKey</code>) or from update (for <code>UpdateApiKey</code>).</p>",
"documentation":"<p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the field values, and try again. </p>",
"error":{"httpStatusCode":400},
"exception":true
},
"Blob":{"type":"blob"},
"Boolean":{"type":"boolean"},
"ConcurrentModificationException":{
"type":"structure",
"members":{
"message":{"shape":"ErrorMessage"}
},
"documentation":"<p>Another modification is being made. That modification must complete before you can make your change. </p>",
"error":{"httpStatusCode":409},
"exception":true
},
"CreateApiKeyRequest":{
"type":"structure",
"required":["apiId"],
"members":{
"apiId":{
"shape":"String",
"documentation":"<p>The ID for your GraphQL API.</p>",
"location":"uri",
"locationName":"apiId"
},
"description":{
"shape":"String",
"documentation":"<p>A description of the purpose of the API key.</p>"
"documentation":"<p>The time from creation time after which the API key expires. The date is represented as seconds since the epoch, rounded down to the nearest hour. The default value for this parameter is 7 days from creation time. For more information, see .</p>"
"documentation":"<p>The mapping template to be used for requests.</p> <p>A resolver uses a request mapping template to convert a GraphQL expression into a format that a data source can understand. Mapping templates are written in Apache Velocity Template Language (VTL).</p>"
"documentation":"<p>The type definition, in GraphQL Schema Definition Language (SDL) format.</p> <p>For more information, see the <a href=\"http://graphql.org/learn/schema/\">GraphQL SDL documentation</a>.</p>"
},
"format":{
"shape":"TypeDefinitionFormat",
"documentation":"<p>The type format: SDL or JSON.</p>"
"documentation":"<p>The type of the data source.</p> <ul> <li> <p> <b>AMAZON_DYNAMODB</b>: The data source is an Amazon DynamoDB table.</p> </li> <li> <p> <b>AMAZON_ELASTICSEARCH</b>: The data source is an Amazon Elasticsearch Service domain.</p> </li> <li> <p> <b>AWS_LAMBDA</b>: The data source is an AWS Lambda function.</p> </li> <li> <p> <b>NONE</b>: There is no data source. This type is used when when you wish to invoke a GraphQL operation without connecting to a data source, such as performing data transformation with resolvers or triggering a subscription to be invoked from a mutation.</p> </li> <li> <p> <b>HTTP</b>: The data source is an HTTP endpoint.</p> </li> </ul>"
"documentation":"<p>The schema format: SDL or JSON.</p>",
"location":"querystring",
"locationName":"format"
}
}
},
"GetIntrospectionSchemaResponse":{
"type":"structure",
"members":{
"schema":{
"shape":"Blob",
"documentation":"<p>The schema, in GraphQL Schema Definition Language (SDL) format.</p> <p>For more information, see the <a href=\"http://graphql.org/learn/schema/\">GraphQL SDL documentation</a>.</p>"
}
},
"payload":"schema"
},
"GetResolverRequest":{
"type":"structure",
"required":[
"apiId",
"typeName",
"fieldName"
],
"members":{
"apiId":{
"shape":"String",
"documentation":"<p>The API ID.</p>",
"location":"uri",
"locationName":"apiId"
},
"typeName":{
"shape":"ResourceName",
"documentation":"<p>The resolver type name.</p>",
"location":"uri",
"locationName":"typeName"
},
"fieldName":{
"shape":"ResourceName",
"documentation":"<p>The resolver field name.</p>",
"documentation":"<p>The Http url endpoint. You can either specify the domain name or ip and port combination and the url scheme must be http(s). If the port is not specified, AWS AppSync will use the default port 80 for http endpoint and port 443 for https endpoints.</p>"
}
},
"documentation":"<p>Describes a Http data source configuration.</p>"
"documentation":"<p>An internal AWS AppSync error occurred. Try your request again.</p>",
"error":{"httpStatusCode":500},
"exception":true,
"fault":true
},
"LambdaDataSourceConfig":{
"type":"structure",
"required":["lambdaFunctionArn"],
"members":{
"lambdaFunctionArn":{
"shape":"String",
"documentation":"<p>The ARN for the Lambda function.</p>"
}
},
"documentation":"<p>Describes a Lambda data source configuration.</p>"
},
"LimitExceededException":{
"type":"structure",
"members":{
"message":{"shape":"String"}
},
"documentation":"<p>The request exceeded a limit. Try your request again.</p>",
"error":{"httpStatusCode":429},
"exception":true
},
"ListApiKeysRequest":{
"type":"structure",
"required":["apiId"],
"members":{
"apiId":{
"shape":"String",
"documentation":"<p>The API ID.</p>",
"location":"uri",
"locationName":"apiId"
},
"nextToken":{
"shape":"PaginationToken",
"documentation":"<p>An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.</p>",
"location":"querystring",
"locationName":"nextToken"
},
"maxResults":{
"shape":"MaxResults",
"documentation":"<p>The maximum number of results you want the request to return.</p>",
"documentation":"<p>An identifier to be passed in the next request to this operation to return the next set of items in the list.</p>"
}
}
},
"ListDataSourcesRequest":{
"type":"structure",
"required":["apiId"],
"members":{
"apiId":{
"shape":"String",
"documentation":"<p>The API ID.</p>",
"location":"uri",
"locationName":"apiId"
},
"nextToken":{
"shape":"PaginationToken",
"documentation":"<p>An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list. </p>",
"location":"querystring",
"locationName":"nextToken"
},
"maxResults":{
"shape":"MaxResults",
"documentation":"<p>The maximum number of results you want the request to return.</p>",
"documentation":"<p>An identifier to be passed in the next request to this operation to return the next set of items in the list.</p>"
}
}
},
"ListGraphqlApisRequest":{
"type":"structure",
"members":{
"nextToken":{
"shape":"PaginationToken",
"documentation":"<p>An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list. </p>",
"location":"querystring",
"locationName":"nextToken"
},
"maxResults":{
"shape":"MaxResults",
"documentation":"<p>The maximum number of results you want the request to return.</p>",
"documentation":"<p>An identifier to be passed in the next request to this operation to return the next set of items in the list.</p>"
}
}
},
"ListResolversRequest":{
"type":"structure",
"required":[
"apiId",
"typeName"
],
"members":{
"apiId":{
"shape":"String",
"documentation":"<p>The API ID.</p>",
"location":"uri",
"locationName":"apiId"
},
"typeName":{
"shape":"String",
"documentation":"<p>The type name.</p>",
"location":"uri",
"locationName":"typeName"
},
"nextToken":{
"shape":"PaginationToken",
"documentation":"<p>An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list. </p>",
"location":"querystring",
"locationName":"nextToken"
},
"maxResults":{
"shape":"MaxResults",
"documentation":"<p>The maximum number of results you want the request to return.</p>",
"documentation":"<p>An identifier to be passed in the next request to this operation to return the next set of items in the list.</p>"
}
}
},
"ListTypesRequest":{
"type":"structure",
"required":[
"apiId",
"format"
],
"members":{
"apiId":{
"shape":"String",
"documentation":"<p>The API ID.</p>",
"location":"uri",
"locationName":"apiId"
},
"format":{
"shape":"TypeDefinitionFormat",
"documentation":"<p>The type format: SDL or JSON.</p>",
"location":"querystring",
"locationName":"format"
},
"nextToken":{
"shape":"PaginationToken",
"documentation":"<p>An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list. </p>",
"location":"querystring",
"locationName":"nextToken"
},
"maxResults":{
"shape":"MaxResults",
"documentation":"<p>The maximum number of results you want the request to return.</p>",
"documentation":"<p>The field logging level. Values can be NONE, ERROR, ALL. </p> <ul> <li> <p> <b>NONE</b>: No field-level logs are captured.</p> </li> <li> <p> <b>ERROR</b>: Logs the following information only for the fields that are in error:</p> <ul> <li> <p>The error section in the server response.</p> </li> <li> <p>Field-level errors.</p> </li> <li> <p>The generated request/response functions that got resolved for error fields.</p> </li> </ul> </li> <li> <p> <b>ALL</b>: The following information is logged for all fields in the query:</p> <ul> <li> <p>Field-level tracing information.</p> </li> <li> <p>The generated request/response functions that got resolved for each field.</p> </li> </ul> </li> </ul>"
},
"cloudWatchLogsRoleArn":{
"shape":"String",
"documentation":"<p>The service role that AWS AppSync will assume to publish to Amazon CloudWatch logs in your account. </p>"
"documentation":"<p>The issuer for the open id connect configuration. The issuer returned by discovery MUST exactly match the value of iss in the ID Token.</p>"
},
"clientId":{
"shape":"String",
"documentation":"<p>The client identifier of the Relying party at the OpenID Provider. This identifier is typically obtained when the Relying party is registered with the OpenID Provider. You can specify a regular expression so the AWS AppSync can validate against multiple client identifiers at a time</p>"
},
"iatTTL":{
"shape":"Long",
"documentation":"<p>The number of milliseconds a token is valid after being issued to a user.</p>"
},
"authTTL":{
"shape":"Long",
"documentation":"<p>The number of milliseconds a token is valid after being authenticated.</p>"
}
},
"documentation":"<p>Describes an Open Id Connect configuration.</p>"
"documentation":"<p>The time from update time after which the API key expires. The date is represented as seconds since the epoch. For more information, see .</p>"
"documentation":"<p>The AWS region in which the user pool was created.</p>"
},
"defaultAction":{
"shape":"DefaultAction",
"documentation":"<p>The action that you want your GraphQL API to take when a request that uses Amazon Cognito User Pool authentication doesn't match the Amazon Cognito User Pool configuration.</p>"
},
"appIdClientRegex":{
"shape":"String",
"documentation":"<p>A regular expression for validating the incoming Amazon Cognito User Pool app client ID.</p>"
}
},
"documentation":"<p>Describes an Amazon Cognito User Pool configuration.</p>"
}
},
"documentation":"<p>AWS AppSync provides API actions for creating and interacting with data sources using GraphQL from your application.</p>"