feat(client-appsync): This release adds additional configurations on …

…GraphQL APIs for limits on query depth, resolver count, and introspection
aws · Dec 19, 2023 · a69d6cf · a69d6cf
1 parent 02c79f9
commit a69d6cf
Show file tree

Hide file tree

Showing 69 changed files with 960 additions and 839 deletions.
diff --git a/clients/client-appsync/README.md b/clients/client-appsync/README.md
@@ -6,8 +6,8 @@
 
 AWS SDK for JavaScript AppSync Client for Node.js, Browser and React Native.
 
-<p>AppSync provides API actions for creating and interacting with data
-sources using GraphQL from your application.</p>
+<p>AppSync provides API actions for creating and interacting with data sources using GraphQL
+from your application.</p>
 
 ## Installing
 

diff --git a/clients/client-appsync/src/AppSync.ts b/clients/client-appsync/src/AppSync.ts
@@ -1226,8 +1226,8 @@ export interface AppSync {
 
 /**
  * @public
- * <p>AppSync provides API actions for creating and interacting with data
- *          sources using GraphQL from your application.</p>
+ * <p>AppSync provides API actions for creating and interacting with data sources using GraphQL
+ *          from your application.</p>
  */
 export class AppSync extends AppSyncClient implements AppSync {}
 createAggregatedClient(commands, AppSync);
diff --git a/clients/client-appsync/src/AppSyncClient.ts b/clients/client-appsync/src/AppSyncClient.ts
@@ -475,8 +475,8 @@ export interface AppSyncClientResolvedConfig extends AppSyncClientResolvedConfig
 
 /**
  * @public
- * <p>AppSync provides API actions for creating and interacting with data
- *          sources using GraphQL from your application.</p>
+ * <p>AppSync provides API actions for creating and interacting with data sources using GraphQL
+ *          from your application.</p>
  */
 export class AppSyncClient extends __Client<
   __HttpHandlerOptions,

diff --git a/clients/client-appsync/src/commands/AssociateApiCommand.ts b/clients/client-appsync/src/commands/AssociateApiCommand.ts
@@ -71,15 +71,14 @@ export interface AssociateApiCommandOutput extends AssociateApiResponse, __Metad
  *  <p>You don't have access to perform this operation on this resource.</p>
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link AppSyncServiceException}
  * <p>Base exception class for all service exceptions from AppSync service.</p>

diff --git a/clients/client-appsync/src/commands/AssociateMergedGraphqlApiCommand.ts b/clients/client-appsync/src/commands/AssociateMergedGraphqlApiCommand.ts
@@ -81,12 +81,12 @@ export interface AssociateMergedGraphqlApiCommandOutput extends AssociateMergedG
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
@@ -95,8 +95,7 @@ export interface AssociateMergedGraphqlApiCommandOutput extends AssociateMergedG
  *  <p>The request exceeded a limit. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/AssociateSourceGraphqlApiCommand.ts b/clients/client-appsync/src/commands/AssociateSourceGraphqlApiCommand.ts
@@ -81,12 +81,12 @@ export interface AssociateSourceGraphqlApiCommandOutput extends AssociateSourceG
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
@@ -95,8 +95,7 @@ export interface AssociateSourceGraphqlApiCommandOutput extends AssociateSourceG
  *  <p>The request exceeded a limit. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/CreateApiCacheCommand.ts b/clients/client-appsync/src/commands/CreateApiCacheCommand.ts
@@ -74,19 +74,18 @@ export interface CreateApiCacheCommandOutput extends CreateApiCacheResponse, __M
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/CreateApiKeyCommand.ts b/clients/client-appsync/src/commands/CreateApiKeyCommand.ts
@@ -76,8 +76,8 @@ export interface CreateApiKeyCommandOutput extends CreateApiKeyResponse, __Metad
  *             <code>CreateApiKey</code>) or from update (for <code>UpdateApiKey</code>).</p>
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
@@ -86,8 +86,7 @@ export interface CreateApiKeyCommandOutput extends CreateApiKeyResponse, __Metad
  *  <p>The request exceeded a limit. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/CreateDataSourceCommand.ts b/clients/client-appsync/src/commands/CreateDataSourceCommand.ts
@@ -162,19 +162,18 @@ export interface CreateDataSourceCommandOutput extends CreateDataSourceResponse,
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/CreateDomainNameCommand.ts b/clients/client-appsync/src/commands/CreateDomainNameCommand.ts
@@ -73,8 +73,8 @@ export interface CreateDomainNameCommandOutput extends CreateDomainNameResponse,
  *  <p>You don't have access to perform this operation on this resource.</p>
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>

diff --git a/clients/client-appsync/src/commands/CreateFunctionCommand.ts b/clients/client-appsync/src/commands/CreateFunctionCommand.ts
@@ -38,8 +38,7 @@ export interface CreateFunctionCommandOutput extends CreateFunctionResponse, __M
 /**
  * @public
  * <p>Creates a <code>Function</code> object.</p>
- *          <p>A function is a reusable entity. You can use multiple functions to compose the resolver
- *          logic.</p>
+ *          <p>A function is a reusable entity. You can use multiple functions to compose the resolver logic.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -105,15 +104,14 @@ export interface CreateFunctionCommandOutput extends CreateFunctionResponse, __M
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/CreateGraphqlApiCommand.ts b/clients/client-appsync/src/commands/CreateGraphqlApiCommand.ts
@@ -98,6 +98,9 @@ export interface CreateGraphqlApiCommandOutput extends CreateGraphqlApiResponse,
  *   apiType: "GRAPHQL" || "MERGED",
  *   mergedApiExecutionRoleArn: "STRING_VALUE",
  *   ownerContact: "STRING_VALUE",
+ *   introspectionConfig: "ENABLED" || "DISABLED",
+ *   queryDepthLimit: Number("int"),
+ *   resolverCountLimit: Number("int"),
  * };
  * const command = new CreateGraphqlApiCommand(input);
  * const response = await client.send(command);
@@ -166,6 +169,9 @@ export interface CreateGraphqlApiCommandOutput extends CreateGraphqlApiResponse,
  * //     mergedApiExecutionRoleArn: "STRING_VALUE",
  * //     owner: "STRING_VALUE",
  * //     ownerContact: "STRING_VALUE",
+ * //     introspectionConfig: "ENABLED" || "DISABLED",
+ * //     queryDepthLimit: Number("int"),
+ * //     resolverCountLimit: Number("int"),
  * //   },
  * // };
  *
@@ -181,12 +187,12 @@ export interface CreateGraphqlApiCommandOutput extends CreateGraphqlApiResponse,
  *  <p>The GraphQL API exceeded a limit. Try your request again.</p>
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>

diff --git a/clients/client-appsync/src/commands/CreateResolverCommand.ts b/clients/client-appsync/src/commands/CreateResolverCommand.ts
@@ -38,8 +38,8 @@ export interface CreateResolverCommandOutput extends CreateResolverResponse, __M
 /**
  * @public
  * <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>
+ *          <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -126,19 +126,18 @@ export interface CreateResolverCommandOutput extends CreateResolverResponse, __M
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/CreateTypeCommand.ts b/clients/client-appsync/src/commands/CreateTypeCommand.ts
@@ -70,19 +70,18 @@ export interface CreateTypeCommandOutput extends CreateTypeResponse, __MetadataB
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/DeleteApiCacheCommand.ts b/clients/client-appsync/src/commands/DeleteApiCacheCommand.ts
@@ -60,19 +60,18 @@ export interface DeleteApiCacheCommandOutput extends DeleteApiCacheResponse, __M
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
- *  <p>Another modification is in progress at this time and it must complete before you can
- *          make your change.</p>
+ *  <p>Another modification is in progress at this time and it must complete before you can make your
+ *          change.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>

diff --git a/clients/client-appsync/src/commands/DeleteApiKeyCommand.ts b/clients/client-appsync/src/commands/DeleteApiKeyCommand.ts
@@ -61,15 +61,14 @@ export interface DeleteApiKeyCommandOutput extends DeleteApiKeyResponse, __Metad
  * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
  *
  * @throws {@link BadRequestException} (client fault)
- *  <p>The request is not well formed. For example, a value is invalid or a required field is
- *          missing. Check the field values, and then try again.</p>
+ *  <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the
+ *          field values, and then try again.</p>
  *
  * @throws {@link InternalFailureException} (server fault)
  *  <p>An internal AppSync error occurred. Try your request again.</p>
  *
  * @throws {@link NotFoundException} (client fault)
- *  <p>The resource specified in the request was not found. Check the resource, and then try
- *          again.</p>
+ *  <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
  *
  * @throws {@link UnauthorizedException} (client fault)
  *  <p>You aren't authorized to perform this operation.</p>