# API do programador do crawler
<a name="aws-glue-api-crawler-scheduler"></a>

A API Crawler scheduler descreve os tipos de dados de crawler do AWS Glue, juntamente com a API para criar, excluir, atualizar e listar crawlers.

## Tipos de dados
<a name="aws-glue-api-crawler-scheduler-objects"></a>
+ [Estrutura Schedule](#aws-glue-api-crawler-scheduler-Schedule)

## Estrutura Schedule
<a name="aws-glue-api-crawler-scheduler-Schedule"></a>

Um objeto de programação que usa uma instrução `cron` para programar um evento.

**Campos**
+ `ScheduleExpression` – String UTF-8.

  Uma expressão `cron` usada para especificar a programação (consulte [Programações baseadas em hora para tarefas e crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html). Por exemplo, para executar algo todos os dias às 12h15 UTC, especifique: `cron(15 12 * * ? *)`.
+ `State` – String UTF-8 (valores válidos: `SCHEDULED` \$1 `NOT_SCHEDULED` \$1 `TRANSITIONING`).

  O estado da programação.

## Operações
<a name="aws-glue-api-crawler-scheduler-actions"></a>
+ [Ação UpdateCrawlerSchedule (Python: update\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule)
+ [Ação StartCrawlerSchedule (Python: start\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-StartCrawlerSchedule)
+ [Ação StopCrawlerSchedule (Python: stop\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-StopCrawlerSchedule)

## Ação UpdateCrawlerSchedule (Python: update\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule"></a>

Atualiza a programação de um crawler usando uma expressão `cron`. 

**Solicitação**
+ `CrawlerName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do crawler cuja programação será atualizada.
+ `Schedule` – String UTF-8.

  A expressão `cron` atualizada usada para especificar a programação (consulte [Programações baseadas em hora para tarefas e crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html)). Por exemplo, para executar algo todos os dias às 12h15 UTC, especifique: `cron(15 12 * * ? *)`.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `VersionMismatchException`
+ `SchedulerTransitioningException`
+ `OperationTimeoutException`

## Ação StartCrawlerSchedule (Python: start\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-StartCrawlerSchedule"></a>

Altera o estado da programação do crawler especificado para `SCHEDULED`, a menos que ele já esteja em execução ou o estado da programação já seja `SCHEDULED`.

**Solicitação**
+ `CrawlerName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome do crawler a ser programado.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `EntityNotFoundException`
+ `SchedulerRunningException`
+ `SchedulerTransitioningException`
+ `NoScheduleException`
+ `OperationTimeoutException`

## Ação StopCrawlerSchedule (Python: stop\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-StopCrawlerSchedule"></a>

Define o estado da programação do crawler especificado para `NOT_SCHEDULED`, mas não o interrompe se já estiver em execução.

**Solicitação**
+ `CrawlerName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome do crawler cujo estado da programação será definido.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `EntityNotFoundException`
+ `SchedulerNotRunningException`
+ `SchedulerTransitioningException`
+ `OperationTimeoutException`