Fluxos de trabalho

A API de fluxos de trabalho descreve os tipos de dados e a API relacionados à criação, atualização ou exibição de fluxos de trabalho no AWS Glue. O histórico de execução de trabalhos pode ser acessado por 90 dias para seu fluxo de trabalho e execução de trabalhos.

Tipos de dados

• Estrutura JobNodeDetails

• Estrutura CrawlerNodeDetails

• Estrutura TriggerNodeDetails

• Estrutura Crawl

• Estrutura Node

• Estrutura Edge

• Estrutura Workflow

• Estrutura WorkflowGraph

• Estrutura WorkflowRun

• Estrutura WorkflowRunStatistics

• Estrutura StartingEventBatchCondition

• Estrutura Blueprint

• Estrutura BlueprintDetails

• Estrutura LastActiveDefinition

• Estrutura BlueprintRun

Estrutura JobNodeDetails

Os detalhes de um nó de tarefa presente no fluxo de trabalho.

Campos

• JobRuns – Uma matriz de objetos JobRun.

  As informações da execução da tarefa representada pelo nó de tarefa.

Estrutura CrawlerNodeDetails

Os detalhes de um nó de crawler presente no fluxo de trabalho.

Campos

• Crawls – Uma matriz de objetos Crawl.

  Uma lista de monitoramentos representados pelo nó de monitoramento.

Estrutura TriggerNodeDetails

Os detalhes de um nó de gatilho presente no fluxo de trabalho.

Campos

• Trigger – Um objeto Trigger.

  As informações do gatilho representado pelo nó de gatilho.

Estrutura Crawl

Os detalhes de um monitoramento no fluxo de trabalho

Campos

• State – String UTF-8 (valores válidos: RUNNING | CANCELLING | CANCELLED | SUCCEEDED | FAILED | ERROR).

  O estado do crawler.

• StartedOn – Timestamp.

  A data e a hora em que o monitoramento foi iniciado.

• CompletedOn – Timestamp.

  A data e a hora em que o monitoramento foi concluído.

• ErrorMessage – String de descrição, inferior a 2048 bytes de comprimento, correspondente a URI address multi-line string pattern.

  A mensagem de erro associada ao crawl.

• LogGroup – String UTF-8, superior a 1 e inferior a 512 bytes de comprimento, correspondente a Log group string pattern.

  O grupo de logs associado ao crawl.

• LogStream – String UTF-8, superior a 1 e inferior a 512 bytes de comprimento, correspondente a Log-stream string pattern.

  O fluxo de logs associado ao rastreamento.

Estrutura Node

Um nó representa um componente AWS Glue (acionador, crawler ou trabalho) em um gráfico de fluxo de trabalho.

Campos

• Type – String UTF-8 (valores válidos: CRAWLER | JOB | TRIGGER).

  O tipo de componente do AWS Glue representado pelo nó.

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do componente do AWS Glue representado pelo nó.

• UniqueId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID exclusivo atribuído ao nó no fluxo de trabalho.

• TriggerDetails – Um objeto TriggerNodeDetails.

  Detalhes do gatilho quando o nó representa um gatilho.

• JobDetails – Um objeto JobNodeDetails.

  Detalhes da tarefa quando o nó representa uma tarefa.

• CrawlerDetails – Um objeto CrawlerNodeDetails.

  Detalhes do crawler quando o nó representa um crawler.

Estrutura Edge

Uma borda representa uma conexão direta entre dois componentes do AWS Glue que fazem parte do fluxo de trabalho ao qual a borda pertence.

Campos

• SourceId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O exclusivo do nó no fluxo de trabalho onde a borda é iniciada.

• DestinationId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O exclusivo do nó no fluxo de trabalho onde a borda é finalizada.

Estrutura Workflow

Um fluxo de trabalho é uma colação de vários trabalhos e crawlers do AWS Glue dependentes, que são executados para concluir uma tarefa de ETL complexa. Um fluxo de trabalho gerencia a execução e o monitoramento de todos os seus trabalhos e crawlers.

Campos

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do fluxo de trabalho.

• Description – String UTF-8.

  Uma descrição do fluxo de trabalho.

• DefaultRunProperties – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 255 bytes, correspondente a Single-line string pattern.

  Cada valor é uma sequência de caracteres UTF-8.

  Um conjunto de propriedades a serem usadas como parte de cada execução do fluxo de trabalho. As propriedades de execução são disponibilizadas para cada trabalho no fluxo de trabalho. Um trabalho pode modificar as propriedades dos próximos trabalhos no fluxo.

• CreatedOn – Timestamp.

  A data e a hora em que o fluxo de trabalho foi criado.

• LastModifiedOn – Timestamp.

  A data e a hora em que o fluxo de trabalho foi modificado pela última vez.

• LastRun – Um objeto WorkflowRun.

  As informações sobre a última execução do fluxo de trabalho.

• Graph – Um objeto WorkflowGraph.

  O gráfico que representa todos os componentes do AWS Glue que pertencem ao fluxo de trabalho como nós e conexões direcionadas entre eles como bordas.

• CreationStatus – String UTF-8 (valores válidos: CREATING | CREATED | CREATION_FAILED).

  O status de criação do fluxo de trabalho.

• MaxConcurrentRuns – Número (íntegro).

  Você pode usar esse parâmetro para evitar várias atualizações indesejadas de dados, para controlar custos ou, em alguns casos, evitar que exceda o número máximo de execuções simultâneas de qualquer um dos trabalhos do componente. Se você deixar esse parâmetro em branco, não haverá limite para o número de execuções de fluxo de trabalho simultâneas.

• BlueprintDetails – Um objeto BlueprintDetails.

  Essa estrutura indica os detalhes do blueprint do qual esse fluxo de trabalho específico foi criado.

Estrutura WorkflowGraph

Um gráfico de fluxo de trabalho representa o fluxo de trabalho completo que contém todos os componentes do AWS Glue presentes no fluxo de trabalho e todas as conexões direcionadas entre eles.

Campos

• Nodes – Uma matriz de objetos Nó.

  Uma lista dos componentes do AWS Glue que pertencem ao fluxo de trabalho representados como nós.

• Edges – Uma matriz de objetos Borda.

  Uma lista de todas as conexões direcionadas entre os nós que pertencem ao fluxo de trabalho.

Estrutura WorkflowRun

Uma execução de fluxo de trabalho é uma execução de um fluxo de trabalho que fornece todas as informações do runtime.

Campos

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome do fluxo de trabalho que foi executado.

• WorkflowRunId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID dessa execução de fluxo de trabalho.

• PreviousRunId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da execução do fluxo de trabalho anterior.

• WorkflowRunProperties – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 255 bytes, correspondente a Single-line string pattern.

  Cada valor é uma sequência de caracteres UTF-8.

  As propriedades da execução do fluxo de trabalho que foram definidas durante a execução.

• StartedOn – Timestamp.

  A data e a hora em que a execução do fluxo de trabalho foi iniciada.

• CompletedOn – Timestamp.

  A data e a hora em que a execução do fluxo de trabalho foi concluída.

• Status – String UTF-8 (valores válidos: RUNNING | COMPLETED | STOPPING | STOPPED | ERROR).

  O status da execução do fluxo de trabalho.

• ErrorMessage – String UTF-8.

  Essa mensagem de erro descreve qualquer erro que possa ter ocorrido ao iniciar a execução do fluxo de trabalho. Atualmente, a única mensagem de erro é “Concurrent runs exceeded for workflow: foo” (Execuções simultâneas excedidas para fluxo de trabalho: foo).

• Statistics – Um objeto WorkflowRunStatistics.

  As estatísticas da execução.

• Graph – Um objeto WorkflowGraph.

  O gráfico que representa todos os componentes do AWS Glue que pertencem ao fluxo de trabalho como nós e conexões direcionadas entre eles como bordas.

• StartingEventBatchCondition – Um objeto StartingEventBatchCondition.

  A condição do lote que iniciou a execução do fluxo de trabalho.

Estrutura WorkflowRunStatistics

As estatísticas da execução do fluxo de trabalho fornecem estatísticas sobre a execução do fluxo de trabalho.

Campos

• TotalActions – Número (íntegro).

  O número total de ações na execução do fluxo de trabalho.

• TimeoutActions – Número (íntegro).

  O número total de ações que atingiram o tempo limite.

• FailedActions – Número (íntegro).

  O número total de ações que falharam.

• StoppedActions – Número (íntegro).

  O número total de ações que foram interrompidas.

• SucceededActions – Número (íntegro).

  O número total de ações que foram bem-sucedidas.

• RunningActions – Número (íntegro).

  O número total de ações no estado de execução.

• ErroredActions – Número (íntegro).

  Indica a contagem de execuções de trabalho no estado ERROR (ERRO) na execução do fluxo de trabalho.

• WaitingActions – Número (íntegro).

  Indica a contagem de execuções de trabalho no estado WAITING (AGUARDANDO) na execução do fluxo de trabalho.

Estrutura StartingEventBatchCondition

A condição do lote que iniciou a execução do fluxo de trabalho. Ou o número de eventos no tamanho do lote chegou, caso em que o membro BatchSize é diferente de zero, ou a janela do lote expirou, caso em que o membro BatchWindow é diferente de zero.

Campos

• BatchSize – Número (íntegro).

  Número de eventos no lote.

• BatchWindow – Número (íntegro).

  Duração da janela do lote em segundos.

Estrutura Blueprint

Os detalhes de um blueprint.

Campos

• Name: string UTF-8, não menos do que 1 ou superior a 128 bytes de comprimento, correspondente a Custom string pattern #27.

  O nome do blueprint.

• Description: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  A descrição do blueprint.

• CreatedOn – Timestamp.

  A data e a hora em que o blueprint foi registrado.

• LastModifiedOn – Timestamp.

  A data e a hora em que o blueprint foi modificado pela última vez.

• ParameterSpec: string UTF-8, não menos do que 1 ou superior a 131.072 bytes de comprimento.

  Uma string JSON que indica a lista de especificações de parâmetros para o blueprint.

• BlueprintLocation – String UTF-8.

  Especifica o caminho no Amazon S3 onde o blueprint é publicado.

• BlueprintServiceLocation – String UTF-8.

  Especifica um caminho no Amazon S3 onde o blueprint é copiado quando você chama CreateBlueprint/UpdateBlueprint para registrá-lo no AWS Glue.

• Status – String UTF-8 (valores válidos: CREATING | ACTIVE | UPDATING | FAILED).

  O status do registro do blueprint.

  • Creating (Criando): o registro do blueprint está em andamento.

  • Active (Ativo): o blueprint foi registrado com sucesso.

  • Updating (Atualizando): uma atualização para o registro do blueprint está em andamento.

  • Failed (Falha): falha no registro do blueprint.

• ErrorMessage – String UTF-8.

  Uma mensagem de erro.

• LastActiveDefinition – Um objeto LastActiveDefinition.

  Quando há várias versões de um blueprint e a versão mais recente apresenta alguns erros, esse atributo indica a última definição do blueprint bem-sucedida que está disponível com o serviço.

Estrutura BlueprintDetails

Os detalhes de um blueprint.

Campos

• BlueprintName: string UTF-8, não menos do que 1 ou superior a 128 bytes de comprimento, correspondente a Custom string pattern #27.

  O nome do blueprint.

• RunId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID de execução desse blueprint.

Estrutura LastActiveDefinition

Quando há várias versões de um blueprint e a versão mais recente apresenta alguns erros, esse atributo indica a última definição do blueprint bem-sucedida que está disponível com o serviço.

Campos

• Description: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  A descrição do blueprint.

• LastModifiedOn – Timestamp.

  A data e a hora em que o blueprint foi modificado pela última vez.

• ParameterSpec: string UTF-8, não menos do que 1 ou superior a 131.072 bytes de comprimento.

  Uma string JSON que especifica os parâmetros para o blueprint.

• BlueprintLocation – String UTF-8.

  Especifica um caminho no Amazon S3 em que o blueprint é publicado pelo desenvolvedor do AWS Glue.

• BlueprintServiceLocation – String UTF-8.

  Especifica um caminho no Amazon S3 onde o esquema é copiado quando você cria ou atualiza o esquema.

Estrutura BlueprintRun

Os detalhes de uma execução de blueprint.

Campos

• BlueprintName: string UTF-8, não menos do que 1 ou superior a 128 bytes de comprimento, correspondente a Custom string pattern #27.

  O nome do blueprint.

• RunId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID de execução para essa execução de blueprint.

• WorkflowName – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome de um fluxo de trabalho criado como resultado de uma execução bem-sucedida do blueprint. Se uma execução de blueprint tiver um erro, não haverá um fluxo de trabalho criado.

• State – String UTF-8 (valores válidos: RUNNING | SUCCEEDED | FAILED | ROLLING_BACK).

  O estado da execução do blueprint. Os valores possíveis são:

  • Running (Executando): a execução do blueprint está em andamento.

  • Succeeded (Êxito): a execução do blueprint foi concluída com êxito.

  • Failed (Falha): a execução do blueprint falhou e a reversão está concluída.

  • Rolling Back (Revertendo): a execução do blueprint falhou e a reversão está em andamento.

• StartedOn – Timestamp.

  A data e a hora em que a execução do blueprint foi iniciada.

• CompletedOn – Timestamp.

  A data e a hora em que a execução do blueprint foi concluída.

• ErrorMessage – String UTF-8.

  Indica os erros que são vistos durante a execução do blueprint.

• RollbackErrorMessage – String UTF-8.

  Se houver erros ao criar as entidades de um fluxo de trabalho, tentamos reverter as entidades criadas até esse ponto e excluí-las. Esse atributo indica os erros vistos ao tentar excluir as entidades que foram criadas.

• Parameters: string UTF-8, não menos do que 1 ou superior a 131.072 bytes de comprimento.

  Os parâmetros do blueprint como uma string. Você terá que fornecer um valor para cada chave exigida pela especificação do parâmetro, que é definida em Blueprint$ParameterSpec.

• RoleArn – String UTF-8, superior a 1 e inferior a 1024 bytes de comprimento, correspondente a Custom string pattern #26.

  O ARN da função. Essa função será assumida pelo produto AWS Glue e será usada para criar o fluxo de trabalho e outras entidades de um fluxo de trabalho.

Operações

• Ação CreateWorkflow (Python: create_workflow)

• Ação UpdateWorkflow (Python: update_workflow)

• Ação DeleteWorkflow (Python: delete_workflow)

• Ação GetWorkflow (Python: get_workflow)

• Ação ListWorkflows (Python: list_workflows)

• Ação BatchGetWorkflows (Python: batch_get_workflows)

• Ação GetWorkflowRun (Python: get_workflow_run)

• Ação GetWorkflowRuns (Python: get_workflow_runs)

• Ação GetWorkflowRunProperties (Python: get_workflow_run_properties)

• Ação PutWorkflowRunProperties (Python: put_workflow_run_properties)

• Ação CreateBlueprint (Python: create_blueprint)

• Ação UpdateBlueprint (Python: update_blueprint)

• Ação DeleteBlueprint (Python: delete_blueprint)

• Ação ListBlueprints (Python: list_blueprints)

• Ação BatchGetBlueprints (Python: batch_get_blueprints)

• Ação StartBlueprintRun (Python: start_blueprint_run)

• Ação GetBlueprintRun (Python: get_blueprint_run)

• Ação GetBlueprintRuns (Python: get_blueprint_runs)

• Ação StartWorkflowRun (Python: start_workflow_run)

• Ação StopWorkflowRun (Python: stop_workflow_run)

• Ação ResumeWorkflowRun (Python: resume_workflow_run)

Ação CreateWorkflow (Python: create_workflow)

Cria uma nova workload.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome a ser atribuído ao fluxo de trabalho. Ele deve ser exclusivo na conta.

• Description – String UTF-8.

  Uma descrição do fluxo de trabalho.

• DefaultRunProperties – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 255 bytes, correspondente a Single-line string pattern.

  Cada valor é uma sequência de caracteres UTF-8.

  Um conjunto de propriedades a serem usadas como parte de cada execução do fluxo de trabalho.

• Tags: uma matriz de mapa dos pares de chave-valor, não mais do que 50 pares.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.

  Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.

  As tags a serem usadas com esse fluxo de trabalho.

• MaxConcurrentRuns – Número (íntegro).

  Você pode usar esse parâmetro para evitar várias atualizações indesejadas de dados, para controlar custos ou, em alguns casos, evitar que exceda o número máximo de execuções simultâneas de qualquer um dos trabalhos do componente. Se você deixar esse parâmetro em branco, não haverá limite para o número de execuções de fluxo de trabalho simultâneas.

Resposta

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do fluxo de trabalho que foi fornecido como parte da solicitação.

Erros

• AlreadyExistsException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ResourceNumberLimitExceededException

• ConcurrentModificationException

Ação UpdateWorkflow (Python: update_workflow)

Atualiza um fluxo de trabalho existente.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome do fluxo de trabalho a ser atualizado.

• Description – String UTF-8.

  A descrição do fluxo de trabalho.

• DefaultRunProperties – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 255 bytes, correspondente a Single-line string pattern.

  Cada valor é uma sequência de caracteres UTF-8.

  Um conjunto de propriedades a serem usadas como parte de cada execução do fluxo de trabalho.

• MaxConcurrentRuns – Número (íntegro).

  Você pode usar esse parâmetro para evitar várias atualizações indesejadas de dados, para controlar custos ou, em alguns casos, evitar que exceda o número máximo de execuções simultâneas de qualquer um dos trabalhos do componente. Se você deixar esse parâmetro em branco, não haverá limite para o número de execuções de fluxo de trabalho simultâneas.

Resposta

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do fluxo de trabalho que foi especificado na entrada.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

Ação DeleteWorkflow (Python: delete_workflow)

Exclui um fluxo de trabalho.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome do fluxo de trabalho a ser excluído.

Resposta

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome do fluxo de trabalho especificado na entrada.

Erros

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

Ação GetWorkflow (Python: get_workflow)

Recupera metadados de recurso para um fluxo de trabalho.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do fluxo de trabalho a ser recuperado.

• IncludeGraph – Booleano.

  Especifica se um gráfico será incluído ao retornar os metadados do recurso do fluxo de trabalho.

Resposta

• Workflow – Um objeto Fluxo de trabalho.

  Os metadados de recurso para o fluxo de trabalho.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

Ação ListWorkflows (Python: list_workflows)

Lista nomes de fluxos de trabalho criados na conta.

Solicitação

• NextToken – String UTF-8.

  Um token de continuação, se esta for uma solicitação de continuação.

• MaxResults: número (inteiro), não inferior a 1 nem superior a 25.

  O tamanho máximo de uma lista a ser retornada.

Resposta

• Workflows: uma matriz de strings UTF-8, não menos do que 1 ou superior a 25 strings.

  Lista de nomes de fluxos de trabalho na conta.

• NextToken – String UTF-8.

  Um token de continuação, caso nem todos os nomes de fluxos de trabalho tenham sido retornados.

Erros

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Ação BatchGetWorkflows (Python: batch_get_workflows)

Retorna uma lista de metadados de recurso para uma lista de nomes de fluxos de trabalho. Depois de chamar a operação ListWorkflows, você pode chamar essa operação para acessar os dados aos quais você recebeu permissões. Essa operação oferece suporte a todas as permissões do IAM, incluindo condições de permissão que usam tags.

Solicitação

• Names – Obrigatório: uma matriz de strings UTF-8, no mínimo 1 ou mais de 25 strings.

  Uma lista de nomes de fluxos de trabalho, que podem ser os nomes retornados pela operação ListWorkflows.

• IncludeGraph – Booleano.

  Especifica se um gráfico será incluído ao retornar os metadados do recurso do fluxo de trabalho.

Resposta

• Workflows: uma matriz de objetos Fluxo de trabalho, não menos do que 1 ou superior a 25 estruturas.

  Uma lista de metadados do recurso do fluxo de trabalho.

• MissingWorkflows: uma matriz de strings UTF-8, não menos do que 1 ou superior a 25 strings.

  Uma lista de nomes de fluxos de trabalho não encontrados.

Erros

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

Ação GetWorkflowRun (Python: get_workflow_run)

Recupera os metadados de determinada execução do fluxo de trabalho. O histórico de execução de trabalhos pode ser acessado por 90 dias para seu fluxo de trabalho e execução de trabalhos.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome do fluxo de trabalho em execução.

• RunId – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da execução do fluxo de trabalho.

• IncludeGraph – Booleano.

  Especifica se deve incluir o gráfico do fluxo de trabalho como resposta ou não.

Resposta

• Run – Um objeto WorkflowRun.

  Os metadados da execução do fluxo de trabalho solicitados.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

Ação GetWorkflowRuns (Python: get_workflow_runs)

Recupera os metadados de todas as execuções de determinado fluxo de trabalho.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome do fluxo de trabalho cujos metadados de execuções devem ser retornados.

• IncludeGraph – Booleano.

  Especifica se deve incluir o gráfico do fluxo de trabalho como resposta ou não.

• NextToken – String UTF-8.

  O tamanho máximo da resposta.

• MaxResults – Número (inteiro), superior a 1 ou mais que 1000.

  O número máximo de execuções do fluxo de trabalho a serem incluídas na resposta.

Resposta

• Runs: uma matriz de objetos WorkflowRun, não menos do que 1 ou superior a 1.000 estruturas.

  Uma lista de objetos de metadados da execução do fluxo de trabalho.

• NextToken – String UTF-8.

  Um token de continuação, se todas as execuções do fluxo de trabalho solicitadas não tiverem sido retornadas.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

Ação GetWorkflowRunProperties (Python: get_workflow_run_properties)

Recupera as propriedades de execução do fluxo de trabalho que foram definidas durante a execução.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome do fluxo de trabalho que foi executado.

• RunId – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da execução do fluxo de trabalho cujas propriedades deveriam ser retornadas.

Resposta

• RunProperties – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 255 bytes, correspondente a Single-line string pattern.

  Cada valor é uma sequência de caracteres UTF-8.

  As propriedades da execução do fluxo de trabalho que foram definidas durante a execução especificada.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

Ação PutWorkflowRunProperties (Python: put_workflow_run_properties)

Coloca as propriedades da execução do fluxo de trabalho especificadas para determinada execução do fluxo de trabalho. Se uma propriedade já existir para a execução especificada, ela substituirá o valor. Caso contrário, a propriedade será adicionada às propriedades existentes.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome do fluxo de trabalho que foi executado.

• RunId – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da execução do fluxo de trabalho para o qual as propriedades de execução deveriam ser atualizadas.

• RunProperties: obrigatório: uma matriz de mapa dos pares de chave-valor.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 255 bytes, correspondente a Single-line string pattern.

  Cada valor é uma sequência de caracteres UTF-8.

  As propriedades para colocar a execução especificada.

Resposta

• Nenhum parâmetro de resposta.

Erros

• AlreadyExistsException

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ResourceNumberLimitExceededException

• ConcurrentModificationException

Ação CreateBlueprint (Python: create_blueprint)

Regista um blueprint com o AWS Glue.

Solicitação

• Name: obrigatório: string UTF-8, não menos do que 1 ou superior a 128 bytes de comprimento, correspondente a Custom string pattern #27.

  O nome do blueprint.

• Description: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  Uma descrição do blueprint.

• BlueprintLocation: obrigatório: string UTF-8, não menos do que 1 ou superior a 8.192 bytes de comprimento, correspondente a Custom string pattern #28.

  Especifica um caminho no Amazon S3 em que o blueprint é publicado.

• Tags: uma matriz de mapa dos pares de chave-valor, não mais do que 50 pares.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.

  Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.

  As tags a serem aplicadas a esse blueprint.

Resposta

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Retorna o nome do blueprint que foi registrado.

Erros

• AlreadyExistsException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• ResourceNumberLimitExceededException

Ação UpdateBlueprint (Python: update_blueprint)

Atualiza um blueprint registrado.

Solicitação

• Name: obrigatório: string UTF-8, não menos do que 1 ou superior a 128 bytes de comprimento, correspondente a Custom string pattern #27.

  O nome do blueprint.

• Description: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  Uma descrição do blueprint.

• BlueprintLocation: obrigatório: string UTF-8, não menos do que 1 ou superior a 8.192 bytes de comprimento, correspondente a Custom string pattern #28.

  Especifica um caminho no Amazon S3 em que o blueprint é publicado.

Resposta

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Retorna o nome do blueprint que foi atualizado.

Erros

• EntityNotFoundException

• ConcurrentModificationException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• IllegalBlueprintStateException

Ação DeleteBlueprint (Python: delete_blueprint)

Exclui um blueprint existente.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do blueprint a ser excluído.

Resposta

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Retorna o nome do blueprint que foi excluído.

Erros

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Ação ListBlueprints (Python: list_blueprints)

Lista todos os nomes de blueprints em uma conta.

Solicitação

• NextToken – String UTF-8.

  Um token de continuação, se esta for uma solicitação de continuação.

• MaxResults: número (inteiro), não inferior a 1 nem superior a 25.

  O tamanho máximo de uma lista a ser retornada.

• Tags: uma matriz de mapa dos pares de chave-valor, não mais do que 50 pares.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.

  Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.

  Filtra a lista por uma tag de recurso da AWS.

Resposta

• Blueprints – Uma matriz de strings UTF-8.

  Lista de nomes de blueprints na conta.

• NextToken – String UTF-8.

  Um token de continuação, se nem todos os nomes de blueprints sejam retornados.

Erros

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Ação BatchGetBlueprints (Python: batch_get_blueprints)

Recupera informações sobre uma lista de blueprints.

Solicitação

• Names – Obrigatório: uma matriz de strings UTF-8, no mínimo 1 ou mais de 25 strings.

  Uma lista de nomes de blueprints.

• IncludeBlueprint – Booleano.

  Especifica se deve incluir o blueprint na resposta ou não.

• IncludeParameterSpec – Booleano.

  Especifica se deve incluir os parâmetros para o blueprint, como uma string JSON, na resposta ou não.

Resposta

• Blueprints – Uma matriz de objetos Blueprint.

  Retorna uma lista de blueprints como um objeto Blueprints.

• MissingBlueprints – Uma matriz de strings UTF-8.

  Retorna uma lista de BlueprintNames que não foram encontrados.

Erros

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

Ação StartBlueprintRun (Python: start_blueprint_run)

Inicia uma nova execução do blueprint especificado.

Solicitação

• BlueprintName: obrigatório: string UTF-8, não menos do que 1 ou superior a 128 bytes de comprimento, correspondente a Custom string pattern #27.

  O nome do blueprint.

• Parameters: string UTF-8, não menos do que 1 ou superior a 131.072 bytes de comprimento.

  Especifica os parâmetros como um objeto BlueprintParameters.

• RoleArn – Obrigatório: string UTF-8, no mínimo 1 ou mais de 1024 bytes de comprimento, correspondente a Custom string pattern #26.

  Especifica a função do IAM usada para criar o fluxo de trabalho.

Resposta

• RunId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID de execução para essa execução de blueprint.

Erros

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• ResourceNumberLimitExceededException

• EntityNotFoundException

• IllegalBlueprintStateException

Ação GetBlueprintRun (Python: get_blueprint_run)

Recupera os detalhes de uma execução de bluetprint.

Solicitação

• BlueprintName: obrigatório: string UTF-8, não menos do que 1 ou superior a 128 bytes de comprimento, correspondente a Custom string pattern #27.

  O nome do blueprint.

• RunId – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID de execução do blueprint que você deseja recuperar.

Resposta

• BlueprintRun – Um objeto BlueprintRun.

  Informa um objeto BlueprintRun.

Erros

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

Ação GetBlueprintRuns (Python: get_blueprint_runs)

Recupera os detalhes das execuções de blueprint para um blueprint especificado.

Solicitação

• BlueprintName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do blueprint.

• NextToken – String UTF-8.

  Um token de continuação, se esta for uma solicitação de continuação.

• MaxResults – Número (inteiro), superior a 1 ou mais que 1000.

  O tamanho máximo de uma lista a ser retornada.

Resposta

• BlueprintRuns – Uma matriz de objetos BlueprintRun.

  Retorna uma lista de objetos BlueprintRun.

• NextToken – String UTF-8.

  Um token de continuação, se nem todas as execuções de blueprint solicitadas forem retornadas.

Erros

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

Ação StartWorkflowRun (Python: start_workflow_run)

Inicia uma nova execução do fluxo de trabalho especificado.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do fluxo de trabalho a ser iniciado.

• RunProperties – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8, com comprimento entre 1 e 255 bytes, correspondente a Single-line string pattern.

  Cada valor é uma sequência de caracteres UTF-8.

  As propriedades de execução de fluxo de trabalho para a nova execução de fluxo de trabalho.

Resposta

• RunId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Um ID para a nova execução.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• ResourceNumberLimitExceededException

• ConcurrentRunsExceededException

Ação StopWorkflowRun (Python: stop_workflow_run)

Interrompe a execução do fluxo de trabalho especificada.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do fluxo de trabalho a ser interrompido.

• RunId – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da execução do fluxo de trabalho a ser interrompida.

Resposta

• Nenhum parâmetro de resposta.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• IllegalWorkflowStateException

Ação ResumeWorkflowRun (Python: resume_workflow_run)

Reinicia os nós selecionados de uma execução de fluxo de trabalho anterior parcialmente concluída e retoma a execução do fluxo de trabalho. Os nós selecionados e todos os nós downstream a eles são executados.

Solicitação

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do fluxo de trabalho a ser retomado.

• RunId – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da execução do fluxo de trabalho a ser retomada.

• NodeIds: obrigatório: uma matriz de strings UTF-8.

  Uma lista de IDs de nó daqueles que você deseja reiniciar. Os nós que devem ser reiniciados devem ter uma tentativa de execução na execução original.

Resposta

• RunId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O novo ID atribuído à execução do fluxo de trabalho retomada. Cada retomada de uma execução de fluxo de trabalho terá um novo ID de execução.

• NodeIds – Uma matriz de strings UTF-8.

  Uma lista de IDs dos nós que foram realmente reiniciados.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• ConcurrentRunsExceededException

• IllegalWorkflowStateException