本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS AppSync
<a name="automation-ref-apsy"></a>

 AWS Systems Manager 自動化為 提供預先定義的 Runbook AWS AppSync。如需有關執行手冊的詳細資訊，請參閱 [Working with runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)。如需如何檢視 Runbook 內容的詳細資訊，請參閱 [檢視 Runbook 內容](automation-runbook-reference.md#view-automation-json)。

**Topics**
+ [`AWS-EnableAppSyncGraphQLApiLogging`](aws-enable-appsync-graphql-api-logging.md)

# `AWS-EnableAppSyncGraphQLApiLogging`
<a name="aws-enable-appsync-graphql-api-logging"></a>

 **Description** 

 `AWS-EnableAppSyncGraphQLApiLogging` Runbook 會為您指定的 AWS AppSync GraphQL API 啟用欄位層級記錄和請求層級記錄。即使已啟用記錄功能， Runbook 仍會將變更套用至指定的 GraphQL API。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-EnableAppSyncGraphQLApiLogging) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 的使用者許可。
+ ApiId

  類型：字串

  描述：（必要） 您要為其啟用記錄的 API ID。
+ FieldLogLevel

  類型：字串

  有效值：錯誤 \$1 ALL

  描述：（必要） 欄位記錄層級。
+ CloudWatchLogsRoleArn

  類型：字串

  描述：（必要） AWS AppSync 擔任發佈至 Amazon CloudWatch Logs 之服務角色的 ARN。
+ ExcludeVerboseContent

  類型：布林值

  預設：False

  描述：（選用） 將 設定為 `True`以排除標頭、內容和評估的映射範本等資訊，無論記錄層級為何。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `appsync:GetGraphqlApi`
+ `appsync:UpdateGraphqlApi`
+ `iam:PassRole`

 **文件步驟** 
+ aws：executeAwsApi - 收集與主要身分驗證類型相關的身分驗證類型和組態資訊。
+ aws：branch - 根據身分驗證類型的分支。
+ aws：executeAwsApi - 根據 Runbook 輸入參數指定的值更新 AWS AppSync GraphQL API 的記錄組態。

 **輸出** 
+ `EnableApiLoggingWithApiKeyOrAwsIamAuthorization.UpdateGraphQLApiResponse`：來自`UpdateGraphqlApi`呼叫的回應。
+ `EnableApiLoggingWithLambdaAuthorization.UpdateGraphQLApiResponse`：來自`UpdateGraphqlApi`呼叫的回應。
+ `EnableApiLoggingWithCognitoAuth.UpdateGraphQLApiResponse`：來自`UpdateGraphqlApi`呼叫的回應。
+ `EnableApiLoggingWithOpenIdAuthorization.UpdateGraphQLApiResponse`：來自`UpdateGraphqlApi`呼叫的回應。