feat(client-appsync): Adds new logging levels (INFO and DEBUG) for ad…

…ditional log output control
aws · Sep 4, 2024 · 3d2c2fa · 3d2c2fa
1 parent bf60228
commit 3d2c2fa
Show file tree

Hide file tree

Showing 5 changed files with 50 additions and 10 deletions.
diff --git a/clients/client-appsync/src/commands/CreateGraphqlApiCommand.ts b/clients/client-appsync/src/commands/CreateGraphqlApiCommand.ts
@@ -38,7 +38,7 @@ export interface CreateGraphqlApiCommandOutput extends CreateGraphqlApiResponse,
  * const input = { // CreateGraphqlApiRequest
  *   name: "STRING_VALUE", // required
  *   logConfig: { // LogConfig
- *     fieldLogLevel: "NONE" || "ERROR" || "ALL", // required
+ *     fieldLogLevel: "NONE" || "ERROR" || "ALL" || "INFO" || "DEBUG", // required
  *     cloudWatchLogsRoleArn: "STRING_VALUE", // required
  *     excludeVerboseContent: true || false,
  *   },
@@ -106,7 +106,7 @@ export interface CreateGraphqlApiCommandOutput extends CreateGraphqlApiResponse,
  * //     apiId: "STRING_VALUE",
  * //     authenticationType: "API_KEY" || "AWS_IAM" || "AMAZON_COGNITO_USER_POOLS" || "OPENID_CONNECT" || "AWS_LAMBDA",
  * //     logConfig: { // LogConfig
- * //       fieldLogLevel: "NONE" || "ERROR" || "ALL", // required
+ * //       fieldLogLevel: "NONE" || "ERROR" || "ALL" || "INFO" || "DEBUG", // required
  * //       cloudWatchLogsRoleArn: "STRING_VALUE", // required
  * //       excludeVerboseContent: true || false,
  * //     },

diff --git a/clients/client-appsync/src/commands/GetGraphqlApiCommand.ts b/clients/client-appsync/src/commands/GetGraphqlApiCommand.ts
@@ -46,7 +46,7 @@ export interface GetGraphqlApiCommandOutput extends GetGraphqlApiResponse, __Met
  * //     apiId: "STRING_VALUE",
  * //     authenticationType: "API_KEY" || "AWS_IAM" || "AMAZON_COGNITO_USER_POOLS" || "OPENID_CONNECT" || "AWS_LAMBDA",
  * //     logConfig: { // LogConfig
- * //       fieldLogLevel: "NONE" || "ERROR" || "ALL", // required
+ * //       fieldLogLevel: "NONE" || "ERROR" || "ALL" || "INFO" || "DEBUG", // required
  * //       cloudWatchLogsRoleArn: "STRING_VALUE", // required
  * //       excludeVerboseContent: true || false,
  * //     },

diff --git a/clients/client-appsync/src/commands/ListGraphqlApisCommand.ts b/clients/client-appsync/src/commands/ListGraphqlApisCommand.ts
@@ -50,7 +50,7 @@ export interface ListGraphqlApisCommandOutput extends ListGraphqlApisResponse, _
  * //       apiId: "STRING_VALUE",
  * //       authenticationType: "API_KEY" || "AWS_IAM" || "AMAZON_COGNITO_USER_POOLS" || "OPENID_CONNECT" || "AWS_LAMBDA",
  * //       logConfig: { // LogConfig
- * //         fieldLogLevel: "NONE" || "ERROR" || "ALL", // required
+ * //         fieldLogLevel: "NONE" || "ERROR" || "ALL" || "INFO" || "DEBUG", // required
  * //         cloudWatchLogsRoleArn: "STRING_VALUE", // required
  * //         excludeVerboseContent: true || false,
  * //       },

diff --git a/clients/client-appsync/src/commands/UpdateGraphqlApiCommand.ts b/clients/client-appsync/src/commands/UpdateGraphqlApiCommand.ts
@@ -39,7 +39,7 @@ export interface UpdateGraphqlApiCommandOutput extends UpdateGraphqlApiResponse,
  *   apiId: "STRING_VALUE", // required
  *   name: "STRING_VALUE", // required
  *   logConfig: { // LogConfig
- *     fieldLogLevel: "NONE" || "ERROR" || "ALL", // required
+ *     fieldLogLevel: "NONE" || "ERROR" || "ALL" || "INFO" || "DEBUG", // required
  *     cloudWatchLogsRoleArn: "STRING_VALUE", // required
  *     excludeVerboseContent: true || false,
  *   },
@@ -102,7 +102,7 @@ export interface UpdateGraphqlApiCommandOutput extends UpdateGraphqlApiResponse,
  * //     apiId: "STRING_VALUE",
  * //     authenticationType: "API_KEY" || "AWS_IAM" || "AMAZON_COGNITO_USER_POOLS" || "OPENID_CONNECT" || "AWS_LAMBDA",
  * //     logConfig: { // LogConfig
- * //       fieldLogLevel: "NONE" || "ERROR" || "ALL", // required
+ * //       fieldLogLevel: "NONE" || "ERROR" || "ALL" || "INFO" || "DEBUG", // required
  * //       cloudWatchLogsRoleArn: "STRING_VALUE", // required
  * //       excludeVerboseContent: true || false,
  * //     },

diff --git a/clients/client-appsync/src/models/models_0.ts b/clients/client-appsync/src/models/models_0.ts
@@ -2465,7 +2465,9 @@ export type GraphQLApiIntrospectionConfig =
  */
 export const FieldLogLevel = {
   ALL: "ALL",
+  DEBUG: "DEBUG",
   ERROR: "ERROR",
+  INFO: "INFO",
   NONE: "NONE",
 } as const;
 
@@ -2480,16 +2482,17 @@ export type FieldLogLevel = (typeof FieldLogLevel)[keyof typeof FieldLogLevel];
  */
 export interface LogConfig {
   /**
-   * <p>The field logging level. Values can be NONE, ERROR, or ALL.</p>
+   * <p>The field logging level. Values can be NONE, ERROR, INFO, DEBUG, or 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>
+   *                   <b>ERROR</b>: Logs the following information
+   *                   <b>only</b> for the fields that are in the error
+   *                category:</p>
    *                <ul>
    *                   <li>
    *                      <p>The error section in the server response.</p>
@@ -2504,14 +2507,51 @@ export interface LogConfig {
    *             </li>
    *             <li>
    *                <p>
+   *                   <b>INFO</b>: Logs the following information <b>only</b> for the fields that are in the info and error
+   *                categories:</p>
+   *                <ul>
+   *                   <li>
+   *                      <p>Info-level messages.</p>
+   *                   </li>
+   *                   <li>
+   *                      <p>The user messages sent through <code>$util.log.info</code> and
+   *                         <code>console.log</code>.</p>
+   *                   </li>
+   *                   <li>
+   *                      <p>Field-level tracing and mapping logs are not shown.</p>
+   *                   </li>
+   *                </ul>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <b>DEBUG</b>: Logs the following information
+   *                   <b>only</b> for the fields that are in the debug, info,
+   *                and error categories:</p>
+   *                <ul>
+   *                   <li>
+   *                      <p>Debug-level messages.</p>
+   *                   </li>
+   *                   <li>
+   *                      <p>The user messages sent through <code>$util.log.info</code>,
+   *                         <code>$util.log.debug</code>, <code>console.log</code>, and
+   *                         <code>console.debug</code>.</p>
+   *                   </li>
+   *                   <li>
+   *                      <p>Field-level tracing and mapping logs are not shown.</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>
+   *                      <p>The generated request/response functions that were resolved for each
+   *                      field.</p>
    *                   </li>
    *                </ul>
    *             </li>