As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 **Descrição** 

 O `AWS-EnableAppSyncGraphQLApiLogging` runbook permite o registro em nível de campo e registro em nível de solicitação para a API AWS AppSync GraphQL que você especificar. O runbook aplicará as alterações na API GraphQL especificada, mesmo que o registro já tenha sido habilitado. 

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-EnableAppSyncGraphQLApiLogging) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ ApiId

  Tipo: string

  Descrição: (Obrigatório) O ID da API para a qual você deseja ativar o registro.
+ FieldLogLevel

  Tipo: string

  Valores válidos: ERROR \$1 ALL

  Descrição: (Obrigatório) O nível de registro do campo.
+ CloudWatchLogsRoleArn

  Tipo: string

  Descrição: (Obrigatório) O ARN da função de serviço que AWS AppSync pressupõe publicar no Amazon Logs. CloudWatch 
+ ExcludeVerboseContent

  Tipo: booliano

  Padrão: False

  Descrição: (Opcional) Defina como `True` para excluir informações como cabeçalhos, contexto e modelos de mapeamento avaliados, independentemente do nível de registro.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `appsync:GetGraphqlApi`
+ `appsync:UpdateGraphqlApi`
+ `iam:PassRole`

 **Etapas do documento** 
+ aws: executeAwsApi - Reúne o tipo de autenticação e as informações de configuração relevantes para o tipo de autenticação principal.
+ aws:branch - Ramificações com base no tipo de autenticação.
+ aws: executeAwsApi - Atualiza a configuração de registro da API AWS AppSync GraphQL com base nos valores especificados para os parâmetros de entrada do runbook.

 **Saídas** 
+ `EnableApiLoggingWithApiKeyOrAwsIamAuthorization.UpdateGraphQLApiResponse`: Resposta da `UpdateGraphqlApi` chamada.
+ `EnableApiLoggingWithLambdaAuthorization.UpdateGraphQLApiResponse`: Resposta da `UpdateGraphqlApi` chamada.
+ `EnableApiLoggingWithCognitoAuth.UpdateGraphQLApiResponse`: Resposta da `UpdateGraphqlApi` chamada.
+ `EnableApiLoggingWithOpenIdAuthorization.UpdateGraphQLApiResponse`: Resposta da `UpdateGraphqlApi` chamada.