API de machine learning

• Estrutura TransformParameters

• Estrutura EvaluationMetrics

• Estrutura MLTransform

• Estrutura FindMatchesParameters

• Estrutura FindMatchesMetrics

• Estrutura ConfusionMatrix

• Estrutura GlueTable

• Estrutura TaskRun

• Estrutura TransformFilterCriteria

• Estrutura TransformSortCriteria

• Estrutura TaskRunFilterCriteria

• Estrutura TaskRunSortCriteria

• Estrutura TaskRunProperties

• Estrutura FindMatchesTaskRunProperties

• Estrutura ImportLabelsTaskRunProperties

• Estrutura ExportLabelsTaskRunProperties

• Estrutura LabelingSetGenerationTaskRunProperties

• Estrutura SchemaColumn

• Estrutura TransformEncryption

• Estrutura MLUserDataEncryption

• Estrutura ColumnImportance

Campos

• TransformType: obrigatório: string UTF-8 (valores válidos: FIND_MATCHES).

  O tipo de transformação de machine learning.

  Para obter informações sobre os tipos de transformações de machine learning, consulte Criação de transformações para machine learning.

• FindMatchesParameters – Um objeto FindMatchesParameters.

  Os parâmetros do algoritmo de busca de correspondências.

Campos

• TransformType: obrigatório: string UTF-8 (valores válidos: FIND_MATCHES).

  O tipo de transformação de machine learning.

• FindMatchesMetrics – Um objeto FindMatchesMetrics.

  As métricas de avaliação do algoritmo de busca de correspondências.

Campos

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

  O ID de transformação exclusivo gerado para a transformação de machine learning. É garantido que o ID será único e não mudará.

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

  Um nome definido pelo usuário para a transformação de machine learning. Não é garantido que os nomes serão únicos, e poderão ser trocados a qualquer momento.

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

  Um texto de descrição de formato longo e definido pelo usuário para a transformação de machine learning. Não é garantido que as descrições serão únicas, e elas poderão mudar a qualquer momento.

• Status – String UTF-8 (valores válidos: NOT_READY | READY | DELETING).

  O status atual da transformação de machine learning.

• CreatedOn – Timestamp.

  Um carimbo de data/hora. A data e hora em que essa transformação de machine learning foi criada.

• LastModifiedOn – Timestamp.

  Um carimbo de data/hora. O último momento em que essa transformação de machine learning foi modificada.

• InputRecordTables: uma matriz de objetos GlueTable, não mais do que dez estruturas.

  Uma lista de definições de tabela do AWS Glue usadas pela transformação.

• Parameters – Um objeto TransformParameters.

  Um objeto TransformParameters. Você pode usar parâmetros para ajustar (personalizar) o comportamento da transformação de machine learning, especificando quais dados ela aprenderá e sua preferência sobre vários tradeoffs (como precisão vs. revocação, ou acurácia vs. custo).

• EvaluationMetrics – Um objeto EvaluationMetrics.

  Um objeto EvaluationMetrics. As métricas de avaliação fornecem uma estimativa da qualidade da transformação de machine learning.

• LabelCount – Número (íntegro).

  Um identificador de contagem para rotular arquivos gerados pelo AWS Glue para essa transformação. À medida que você cria uma transformação melhor, é possível fazer download, rotular e fazer upload do arquivo de rotulamento de maneira interativa.

• Schema: uma matriz de objetos SchemaColumn, não mais de 100 estruturas.

  Um mapa de pares de chave-valor representando as colunas e os tipos de dados que podem ser executados em relação a essa transformação. Tem um limite superior de 100 colunas.

• Role – String UTF-8.

  O nome ou o nome de recurso da Amazon (ARN) da função do IAM com as permissões necessárias. As permissões necessárias incluem as permissões de função de serviço do AWS Glue para recursos do AWS Glue e as permissões do Amazon S3 exigidas pela transformação.

  • Essa função precisa de permissões de função de serviço do AWS Glue para conceder o acesso aos recursos no AWS Glue. Consulte Anexar uma política aos usuários do IAM que acessam o AWS Glue.

  • Essa função precisa de permissão para suas origens, seus destinos, seu diretório temporário, seus scripts e quaisquer bibliotecas do Amazon Simple Storage Service (Amazon S3) usadas pela execução de tarefa nessa transformação.

• GlueVersion – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #20.

  Este valor determina com qual versão de AWS Glue essa transformação de machine learning é compatível. O Glue 1.0 é recomendado para a maioria dos clientes. Se o valor não for definido, a compatibilidade com o Glue 0.9 será definida como padrão. Para obter mais informações, consulte Versões do AWS Glue no guia do desenvolvedor.

• MaxCapacity – Número (duplo).

  O número de unidades de processamento de dados (DPUs) do AWS Glue alocadas para execuções de tarefas para essa transformação. Você pode alocar de 2 a 100 DPUs. O padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a página de definição de preços do AWS Glue.

  MaxCapacity é uma opção mutuamente exclusiva com NumberOfWorkers e WorkerType.

  • Se NumberOfWorkers ou WorkerType estiver definido, MaxCapacity não poderá ser definido.

  • Se MaxCapacity estiver definido, nem NumberOfWorkers e nem WorkerType poderá ser definido.

  • Se WorkerType estiver definido, NumberOfWorkers será necessário (e vice-versa).

  • MaxCapacity e NumberOfWorkers devem ser pelo menos 1.

  Quando o campo WorkerType é definido como um valor diferente de Standard, o campo MaxCapacity é definido automaticamente e se torna somente leitura.

• WorkerType – String UTF-8 (valores válidos: Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="").

  O tipo de operador predefinido alocado quando uma tarefa dessa transformação é executada. Aceita um valor de Standard (Padrão), G.1X ou G.2X.

  • Para o tipo de operador Standard, cada operador fornece 4 vCPU, 16 GB de memória e um disco de 50 GB e 2 executores por operador.

  • Para o tipo de operador G.1X, cada operador fornece 4 vCPU, 16 GB de memória e um disco e 64 GB, 1 executor por operador.

  • Para o tipo de operador G.2X, cada operador fornece 8 vCPU, 32 GB de memória e um disco de 128 GB e 1 executor por operador.

  MaxCapacity é uma opção mutuamente exclusiva com NumberOfWorkers e WorkerType.

  • Se NumberOfWorkers ou WorkerType estiver definido, MaxCapacity não poderá ser definido.

  • Se MaxCapacity estiver definido, nem NumberOfWorkers e nem WorkerType poderá ser definido.

  • Se WorkerType estiver definido, NumberOfWorkers será necessário (e vice-versa).

  • MaxCapacity e NumberOfWorkers devem ser pelo menos 1.

• NumberOfWorkers – Número (íntegro).

  O número de operadores de um workerType definido alocados quando uma tarefa da transformação é executada.

  Se WorkerType estiver definido, NumberOfWorkers será necessário (e vice-versa).

• Timeout – Número (inteiro), pelo menos 1.

  O tempo limite em minutos da transformação de machine learning.

• MaxRetries – Número (íntegro).

  O número máximo de novas tentativas após uma falha de transformação MLTaskRun de machine learning.

• TransformEncryption – Um objeto TransformEncryption.

  As configurações de criptografia em repouso da transformação que se aplicam ao acesso aos dados do usuário. As transformações de machine learning podem acessar dados do usuário criptografados no Amazon S3 usando o KMS.

Campos

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

  O nome de uma coluna que identifica exclusivamente as linhas na tabela de origem. Usado para ajudar a identificar os registros correspondentes.

• PrecisionRecallTradeoff: número (double), no máximo 1,0.

  O valor selecionado ao ajustar a transformação para um equilíbrio entre precisão e revocação. Um valor de 0.5 significa que não há preferência; um valor de 1.0 significa um desvio puramente para precisão, e um valor de 0.0 significa um desvio para revocação. Como este é um tradeoff, escolher valores próximos a 1.0 significa uma revocação muito baixa, e escolher valores próximos a 0.0 resulta em uma precisão muito baixa.

  A métrica de precisão indica a frequência com que seu modelo está correto ao prever uma correspondência.

  A métrica de revocação indica, para uma correspondência real, com que frequência seu modelo prevê a correspondência.

• AccuracyCostTradeoff: número (double), no máximo 1,0.

  O valor selecionado ao ajustar sua transformação para um equilíbrio entre acurácia e custo. Um valor de 0.5 significa que o sistema equilibra as preocupações de acurácia e o custo. Um valor de 1.0 significa um desvio puramente para a acurácia, o que normalmente resulta em um custo mais alto, que é, às vezes, substancialmente superior. Um valor de 0.0 significa um desvio puramente para o custo, o que resulta em uma transformação FindMatches menos precisa e que é, às vezes, uma acurácia inaceitável.

  A acurácia mede quão bem a transformação encontra verdadeiros positivos e verdadeiros negativos. Aumentar a acurácia exige mais recursos de máquina e eleva os custos. Mas isso também resulta em um aumento da revocação.

  O custo avalia o número de recursos de computação, ou seja, o dinheiro, consumidos para executar a transformação.

• EnforceProvidedLabels – Booleano.

  O valor para ativar/desativar a forçar a saída para corresponder aos rótulos fornecidos por usuários. Se o valor for True, a transformação find matches forçará a saída para corresponder aos rótulos fornecidos. Os resultados substituem os resultados de confluência normal. Se o valor for False, a transformação find matches não garantirá que todos os rótulos fornecidos serão respeitados, e os resultados contarão com o modelo treinado.

  Observe que definir esse valor como true pode aumentar o tempo de execução do trabalho.

Campos

• AreaUnderPRCurve: número (double), no máximo 1,0.

  A área sob a curva de precisão/revocação (AUPRC) é um único número único que mede a qualidade geral da transformação, que é independente da escolha feita em precisão vs. revocação. Valores mais altos indicam que você tem um tradeoff de precisão vs. revocação mais atrativo.

  Para obter mais informações, consulte Precisão e revocação na Wikipédia.

• Precision: número (double), no máximo 1,0.

  A métrica de precisão indica a frequência com que sua transformação está correta ao prever uma correspondência. Especificamente, avalia quão bem a transformação encontra verdadeiros positivos do total possível de verdadeiros positivos.

  Para obter mais informações, consulte Precisão e revocação na Wikipédia.

• Recall: número (double), no máximo 1,0.

  A métrica de revocação indica, para uma correspondência real, com que frequência sua transformação prevê a correspondência. Especificamente, avalia quão bem a transformação encontra verdadeiros positivos do total de registros nos dados de origem.

  Para obter mais informações, consulte Precisão e revocação na Wikipédia.

• F1: número (double), no máximo 1,0.

  O F1 máximo indica a acurácia da transformação entre 0 e 1, onde 1 é a melhor acurácia.

  Para obter mais informações, consulte F1 score na Wikipédia.

• ConfusionMatrix – Um objeto ConfusionMatrix.

  A matriz de confusão mostra o que sua transformação está prevendo com precisão, e quais tipos de erros está cometendo.

  Para obter mais informações, consulte Confusion Matrix na Wikipédia.

• ColumnImportances: uma matriz de objetos ColumnImportance, não mais de 100 estruturas.

  Uma lista de estruturas ColumnImportance contendo métricas de importância de coluna, classificadas em ordem de importância decrescente.

Campos

• NumTruePositives – Número (extenso).

  O número de correspondências nos dados que a transformação encontrou corretamente, na matriz de confusão da sua transformação.

• NumFalsePositives – Número (extenso).

  O número de não correspondências nos dados que a transformação incorretamente classificou como correspondências, na matriz de confusão da sua transformação.

• NumTrueNegatives – Número (extenso).

  O número de não correspondências nos dados que a transformação rejeitou corretamente, na matriz de confusão da sua transformação.

• NumFalseNegatives – Número (extenso).

  O número de correspondências nos dados que a transformação não encontrou, na matriz de confusão da sua transformação.

Campos

• DatabaseName – 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 banco de dados no AWS Glue Data Catalog.

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

  O nome da tabela no AWS Glue Data Catalog.

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

  Um identificador exclusivo para o AWS Glue Data Catalog.

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

  O nome da conexão com o AWS Glue Data Catalog.

• AdditionalOptions: uma matriz de mapas de pares chave-valor, não menos que 1 o não mais que 10 pares.

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

  Cada valor é uma string de descrição, com não mais de 2048 de comprimento, correspondo a URI address multi-line string pattern.

  Opções adicionais para a tabela. Atualmente, duas chaves são compatíveis:

  • pushDownPredicate: para filtrar por partições sem a necessidade de listar e ler todos os arquivos do conjunto de dados.

  • catalogPartitionPredicate: para usar a remoção de partições do lado do servidor usando índices de partição no AWS Glue Data Catalog.

Campos

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

  O identificador exclusivo da transformação

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

  O identificador exclusivo para a execução dessa tarefa.

• Status – String UTF-8 (valores válidos: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT).

  O status atual da execução de tarefa solicitada.

• LogGroupName – String UTF-8.

  Os nomes do grupo de log para proteger os registros, associados a essa execução de tarefa.

• Properties – Um objeto TaskRunProperties.

  Especifica as propriedades de configuração associadas à execução de tarefa.

• ErrorString – String UTF-8.

  A lista de strings de erros associadas a essa execução de tarefa.

• StartedOn – Timestamp.

  A data e a hora em que essa execução de tarefa iniciou.

• LastModifiedOn – Timestamp.

  O último momento em que a execução de tarefa foi atualizada.

• CompletedOn – Timestamp.

  O último momento em que a execução de tarefa foi finalizada.

• ExecutionTime – Número (íntegro).

  A quantidade de tempo (em segundos) em que a tarefa executada consumiu recursos.

Campos

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

  Um nome de transformação exclusivo usado para filtrar as transformações de machine learning.

• TransformType – String UTF-8 (valores válidos: FIND_MATCHES).

  O tipo de transformação de machine learning usado para filtrar as transformações de machine learning.

• Status – String UTF-8 (valores válidos: NOT_READY | READY | DELETING).

  Filtra a lista de transformações de machine learning pelo último status conhecido das transformações (para indicar se uma transformação pode ser usada ou não). Um dos "NOT_READY", "READY" ou "DELETING".

• GlueVersion – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #20.

  Este valor determina com qual versão de AWS Glue essa transformação de machine learning é compatível. O Glue 1.0 é recomendado para a maioria dos clientes. Se o valor não for definido, a compatibilidade com o Glue 0.9 será definida como padrão. Para obter mais informações, consulte Versões do AWS Glue no guia do desenvolvedor.

• CreatedBefore – Timestamp.

  A data e hora antes de as transformações serem criadas.

• CreatedAfter – Timestamp.

  A data e hora depois de as transformações serem criadas.

• LastModifiedBefore – Timestamp.

  Filtro da última modificação das transformações antes dessa data.

• LastModifiedAfter – Timestamp.

  Filtro da última modificação das transformações depois dessa data.

• Schema: uma matriz de objetos SchemaColumn, não mais de 100 estruturas.

  Filtros dos conjuntos de dados com um esquema específico. O objeto Map<Column, Type> é uma matriz de pares de chave-valor que representa o esquema que essa transformação aceita, em que Column é o nome de uma coluna, e Type é o tipo dos dados como um número inteiro ou uma string. Tem um limite superior de 100 colunas.

Campos

• Column – obrigatório: string UTF-8 (valores válidos: NAME | TRANSFORM_TYPE | STATUS | CREATED | LAST_MODIFIED).

  A coluna a ser usada nos critérios de classificação que estão associados à transformação de machine learning.

• SortDirection – Obrigatório: string UTF-8 (valores válidos: DESCENDING | ASCENDING).

  A direção da classificação a ser usada nos critérios de classificação associados à transformação de machine learning.

Campos

• TaskRunType – String UTF-8 (valores válidos: EVALUATION | LABELING_SET_GENERATION | IMPORT_LABELS | EXPORT_LABELS | FIND_MATCHES).

  O tipo da tarefa executada.

• Status – String UTF-8 (valores válidos: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT).

  O status atual da tarefa executada.

• StartedBefore – Timestamp.

  Filtra as execuções de tarefas iniciadas antes dessa data.

• StartedAfter – Timestamp.

  Filtra as execuções de tarefas iniciadas após essa data.

Campos

• Column – Obrigatório: string UTF-8 (valores válidos: TASK_RUN_TYPE | STATUS | STARTED).

  A coluna que será usada para classificar a lista de execuções de tarefas para a transformação de machine learning.

• SortDirection – Obrigatório: string UTF-8 (valores válidos: DESCENDING | ASCENDING).

  A direção de classificação que será usada para classificar a lista de execuções de tarefas para a transformação de machine learning.

Campos

• TaskType – String UTF-8 (valores válidos: EVALUATION | LABELING_SET_GENERATION | IMPORT_LABELS | EXPORT_LABELS | FIND_MATCHES).

  O tipo da tarefa executada.

• ImportLabelsTaskRunProperties – Um objeto ImportLabelsTaskRunProperties.

  As propriedades de configuração para uma execução de tarefa de rótulos de importação.

• ExportLabelsTaskRunProperties – Um objeto ExportLabelsTaskRunProperties.

  As propriedades de configuração para uma execução de tarefa de rótulos de exportação.

• LabelingSetGenerationTaskRunProperties – Um objeto LabelingSetGenerationTaskRunProperties.

  As propriedades de configuração para execução de tarefa de geração de conjunto de rótulos.

• FindMatchesTaskRunProperties – Um objeto FindMatchesTaskRunProperties.

  As propriedades de configuração de uma execução de tarefa de busca de correspondências.

Campos

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

  O ID do trabalho da execução de tarefa de busca de correspondências.

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

  O nome atribuído ao trabalho da execução de tarefa de busca de correspondências.

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

  O ID da execução de trabalho para a execução de tarefa de busca de correspondências

Campos

• InputS3Path – String UTF-8.

  O caminho do Amazon Simple Storage Service (Amazon S3) para onde você importará os rótulos.

• Replace – Booleano.

  Indica se você deve substituir os rótulos existentes.

Campos

• OutputS3Path – String UTF-8.

  O caminho do Amazon Simple Storage Service (Amazon S3) de onde você exportará os rótulos.

Campos

• OutputS3Path – String UTF-8.

  O caminho do Amazon Simple Storage Service (Amazon S3) de onde você irá gerar o conjunto de rótulos.

Campos

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

  O nome da coluna.

• DataType – String UTF-8 com comprimento não superior a 131.072 bytes, correspondente a Single-line string pattern.

  O tipo de dados na coluna.

Campos

• MlUserDataEncryption – Um objeto MLUserDataEncryption.

  Um objeto MLUserDataEncryption que contém o modo de criptografia e o ID da chave do KMS fornecida pelo cliente.

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

  O nome da configuração de segurança.

Campos

• MlUserDataEncryptionMode – Obrigatório: string UTF-8 (valores válidos: DISABLED | SSE-KMS="SSEKMS").

  O modo de criptografia aplicado aos dados do usuário. Os valores válidos são:

  • DISABLED: a criptografia está desativada

  • SSEKMS: uso de criptografia no lado do servidor com o AWS Key Management Service (SSE-KMS) para dados do usuário armazenados no Amazon S3.

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

  O ID da chave do KMS fornecida pelo cliente.

Campos

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

  O nome de uma coluna.

• Importance: número (double), no máximo 1,0.

  A pontuação de importância da coluna, como um valor decimal.

• Ação CreateMLTransform (Python: create_ml_transform)

• Ação UpdateMLTransform (Python: update_ml_transform)

• Ação DeleteMLTransform (Python: delete_ml_transform)

• Ação GetMLTransform (Python: get_ml_transform)

• Ação GetMLTransforms (Python: get_ml_transforms)

• Ação ListMLTransforms (Python: list_ml_transforms)

• Ação StartMLEvaluationTaskRun (Python: start_ml_evaluation_task_run)

• Ação StartMLLabelingSetGenerationTaskRun (Python: start_ml_labeling_set_generation_task_run)

• Ação GetMLTaskRun (Python: get_ml_task_run)

• Ação GetMLTaskRuns (Python: get_ml_task_runs)

• Ação CancelMLTaskRun (Python: cancel_ml_task_run)

• Ação StartExportLabelsTaskRun (Python: start_export_labels_task_run)

• Ação StartImportLabelsTaskRun (Python: start_import_labels_task_run)

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 exclusivo que você atribui à transformação quando a cria.

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

  Uma descrição da transformação de machine learning que está sendo definida. O padrão é uma string vazia.

• InputRecordTables - obrigatório: uma matriz de objetos GlueTable, não mais que dez estruturas.

  Uma lista de definições de tabela do AWS Glue usadas pela transformação.

• Parameters – Obrigatório: um objeto TransformParameters.

  Os parâmetros do algoritmo específicos para o tipo de transformação utilizado. Dependente condicionalmente do tipo de transformação.

• Role – Obrigatório: string UTF-8.

  O nome ou o nome de recurso da Amazon (ARN) da função do IAM com as permissões necessárias. As permissões necessárias incluem as permissões de função de serviço do AWS Glue para recursos do AWS Glue e as permissões do Amazon S3 exigidas pela transformação.

  • Essa função precisa de permissões de função de serviço do AWS Glue para conceder o acesso aos recursos no AWS Glue. Consulte Anexar uma política aos usuários do IAM que acessam o AWS Glue.

  • Essa função precisa de permissão para suas origens, seus destinos, seu diretório temporário, seus scripts e quaisquer bibliotecas do Amazon Simple Storage Service (Amazon S3) usadas pela execução de tarefa nessa transformação.

• GlueVersion – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #20.

  Este valor determina com qual versão de AWS Glue essa transformação de machine learning é compatível. O Glue 1.0 é recomendado para a maioria dos clientes. Se o valor não for definido, a compatibilidade com o Glue 0.9 será definida como padrão. Para obter mais informações, consulte Versões do AWS Glue no guia do desenvolvedor.

• MaxCapacity – Número (duplo).

  O número de unidades de processamento de dados (DPUs) do AWS Glue alocadas para execuções de tarefas para essa transformação. Você pode alocar de 2 a 100 DPUs. O padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a página de definição de preços do AWS Glue.

  MaxCapacity é uma opção mutuamente exclusiva com NumberOfWorkers e WorkerType.

  • Se NumberOfWorkers ou WorkerType estiver definido, MaxCapacity não poderá ser definido.

  • Se MaxCapacity estiver definido, nem NumberOfWorkers e nem WorkerType poderá ser definido.

  • Se WorkerType estiver definido, NumberOfWorkers será necessário (e vice-versa).

  • MaxCapacity e NumberOfWorkers devem ser pelo menos 1.

  Quando o campo WorkerType é definido como um valor diferente de Standard, o campo MaxCapacity é definido automaticamente e se torna somente leitura.

  Quando o campo WorkerType é definido como um valor diferente de Standard, o campo MaxCapacity é definido automaticamente e se torna somente leitura.

• WorkerType – String UTF-8 (valores válidos: Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="").

  O tipo de operador predefinido que é alocado quando uma tarefa é executada. Aceita um valor de Standard (Padrão), G.1X ou G.2X.

  • Para o tipo de operador Standard, cada operador fornece 4 vCPU, 16 GB de memória e um disco de 50 GB e 2 executores por operador.

  • Para o tipo de operador G.1X, cada operador fornece 4 vCPU, 16 GB de memória e um disco e 64 GB, 1 executor por operador.

  • Para o tipo de operador G.2X, cada operador fornece 8 vCPU, 32 GB de memória e um disco de 128 GB e 1 executor por operador.

  MaxCapacity é uma opção mutuamente exclusiva com NumberOfWorkers e WorkerType.

  • Se NumberOfWorkers ou WorkerType estiver definido, MaxCapacity não poderá ser definido.

  • Se MaxCapacity estiver definido, nem NumberOfWorkers e nem WorkerType poderá ser definido.

  • Se WorkerType estiver definido, NumberOfWorkers será necessário (e vice-versa).

  • MaxCapacity e NumberOfWorkers devem ser pelo menos 1.

• NumberOfWorkers – Número (íntegro).

  O número de operadores de determinado workerType que são alocados quando uma tarefa é executada.

  Se WorkerType estiver definido, NumberOfWorkers será necessário (e vice-versa).

• Timeout – Número (inteiro), pelo menos 1.

  O tempo limite da execução de tarefa para essa transformação, em minutos. Esse é o tempo máximo durante o qual uma execução de tarefa para essa transformação pode consumir recursos antes de ser encerrada e entrar no status TIMEOUT. O padrão é 2.880 minutos (48 horas).

• MaxRetries – Número (íntegro).

  O número máximo de vezes de novas tentativas dessa transformação após uma execução de tarefa falhar.

• Tags: uma matriz de mapa dos pares de chave-valor, não mais 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 essa transformação de machine learning. É possível usar tags para limitar o acesso à transformação de machine learning. Para obter mais informações sobre tags no AWS Glue, consulte Tags da AWS no AWS Glue no guia do desenvolvedor.

• TransformEncryption – Um objeto TransformEncryption.

  As configurações de criptografia em repouso da transformação que se aplicam ao acesso aos dados do usuário. As transformações de machine learning podem acessar dados do usuário criptografados no Amazon S3 usando o KMS.

Resposta

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

  Um identificador exclusivo gerado para a transformação.

Erros

• AlreadyExistsException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• AccessDeniedException

• ResourceNumberLimitExceededException

• IdempotentParameterMismatchException

Solicitação

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

  Um identificador exclusivo gerado quando a transformação foi criada.

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

  O nome exclusivo que você atribuiu à transformação quando a criou.

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

  Uma descrição da transformação. O padrão é uma string vazia.

• Parameters – Um objeto TransformParameters.

  Os parâmetros de configuração específicos para o tipo de transformação (algoritmo) usado. Dependente condicionalmente do tipo de transformação.

• Role – String UTF-8.

  O nome ou o nome de recurso da Amazon (ARN) da função do IAM com as permissões necessárias.

• GlueVersion – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #20.

  Este valor determina com qual versão de AWS Glue essa transformação de machine learning é compatível. O Glue 1.0 é recomendado para a maioria dos clientes. Se o valor não for definido, a compatibilidade com o Glue 0.9 será definida como padrão. Para obter mais informações, consulte Versões do AWS Glue no guia do desenvolvedor.

• MaxCapacity – Número (duplo).

  O número de unidades de processamento de dados (DPUs) do AWS Glue alocadas para execuções de tarefas para essa transformação. Você pode alocar de 2 a 100 DPUs. O padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a página de definição de preços do AWS Glue.

  Quando o campo WorkerType é definido como um valor diferente de Standard, o campo MaxCapacity é definido automaticamente e se torna somente leitura.

• WorkerType – String UTF-8 (valores válidos: Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="").

  O tipo de operador predefinido que é alocado quando uma tarefa é executada. Aceita um valor de Standard (Padrão), G.1X ou G.2X.

  • Para o tipo de operador Standard, cada operador fornece 4 vCPU, 16 GB de memória e um disco de 50 GB e 2 executores por operador.

  • Para o tipo de operador G.1X, cada operador fornece 4 vCPU, 16 GB de memória e um disco e 64 GB, 1 executor por operador.

  • Para o tipo de operador G.2X, cada operador fornece 8 vCPU, 32 GB de memória e um disco de 128 GB e 1 executor por operador.

• NumberOfWorkers – Número (íntegro).

  O número de operadores de determinado workerType que são alocados quando uma tarefa é executada.

• Timeout – Número (inteiro), pelo menos 1.

  O tempo limite para uma tarefa executar essa transformação em minutos. Esse é o tempo máximo durante o qual uma execução de tarefa para essa transformação pode consumir recursos antes de ser encerrada e entrar no status TIMEOUT. O padrão é 2.880 minutos (48 horas).

• MaxRetries – Número (íntegro).

  O número máximo de vezes de novas tentativas dessa transformação após uma execução de tarefa falhar.

Resposta

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

  O identificador exclusivo para a transformação que foi atualizada.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• AccessDeniedException

Solicitação

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

  O identificador exclusivo da transformação que será excluída.

Resposta

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

  O identificador exclusivo da transformação que foi excluída.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Solicitação

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

  O identificador exclusivo da transformação, gerado no momento em que a transformação é criada.

Resposta

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

  O identificador exclusivo da transformação, gerado no momento em que a transformação é criada.

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

  O nome exclusivo atribuído à transformação quando ela foi criada.

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

  Uma descrição da transformação.

• Status – String UTF-8 (valores válidos: NOT_READY | READY | DELETING).

  O último status conhecido da transformação (para indicar se pode ser usada ou não). Um dos "NOT_READY", "READY" ou "DELETING".

• CreatedOn – Timestamp.

  A data e a hora em que a transformação foi criada.

• LastModifiedOn – Timestamp.

  A data e a hora em que a transformação foi modificada pela última vez.

• InputRecordTables: uma matriz de objetos GlueTable, não mais do que dez estruturas.

  Uma lista de definições de tabela do AWS Glue usadas pela transformação.

• Parameters – Um objeto TransformParameters.

  Os parâmetros de configuração específicos para o algoritmo usado.

• EvaluationMetrics – Um objeto EvaluationMetrics.

  As métricas de avaliação mais recentes.

• LabelCount – Número (íntegro).

  O número de rótulos disponíveis para essa transformação.

• Schema: uma matriz de objetos SchemaColumn, não mais de 100 estruturas.

  O objeto Map<Column, Type> que representa o esquema aceito por essa transformação. Tem um limite superior de 100 colunas.

• Role – String UTF-8.

  O nome ou o nome de recurso da Amazon (ARN) da função do IAM com as permissões necessárias.

• GlueVersion – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #20.

  Este valor determina com qual versão de AWS Glue essa transformação de machine learning é compatível. O Glue 1.0 é recomendado para a maioria dos clientes. Se o valor não for definido, a compatibilidade com o Glue 0.9 será definida como padrão. Para obter mais informações, consulte Versões do AWS Glue no guia do desenvolvedor.

• MaxCapacity – Número (duplo).

  O número de unidades de processamento de dados (DPUs) do AWS Glue alocadas para execuções de tarefas para essa transformação. Você pode alocar de 2 a 100 DPUs. O padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a página de definição de preços do AWS Glue.

  Quando o campo WorkerType é definido como um valor diferente de Standard, o campo MaxCapacity é definido automaticamente e se torna somente leitura.

• WorkerType – String UTF-8 (valores válidos: Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="").

  O tipo de operador predefinido que é alocado quando uma tarefa é executada. Aceita um valor de Standard (Padrão), G.1X ou G.2X.

  • Para o tipo de operador Standard, cada operador fornece 4 vCPU, 16 GB de memória e um disco de 50 GB e 2 executores por operador.

  • Para o tipo de operador G.1X, cada operador fornece 4 vCPU, 16 GB de memória e um disco e 64 GB, 1 executor por operador.

  • Para o tipo de operador G.2X, cada operador fornece 8 vCPU, 32 GB de memória e um disco de 128 GB e 1 executor por operador.

• NumberOfWorkers – Número (íntegro).

  O número de operadores de determinado workerType que são alocados quando uma tarefa é executada.

• Timeout – Número (inteiro), pelo menos 1.

  O tempo limite para uma tarefa executar essa transformação em minutos. Esse é o tempo máximo durante o qual uma execução de tarefa para essa transformação pode consumir recursos antes de ser encerrada e entrar no status TIMEOUT. O padrão é 2.880 minutos (48 horas).

• MaxRetries – Número (íntegro).

  O número máximo de vezes de novas tentativas dessa transformação após uma execução de tarefa falhar.

• TransformEncryption – Um objeto TransformEncryption.

  As configurações de criptografia em repouso da transformação que se aplicam ao acesso aos dados do usuário. As transformações de machine learning podem acessar dados do usuário criptografados no Amazon S3 usando o KMS.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Solicitação

• NextToken – String UTF-8.

  Um token paginado para equilibrar os resultados.

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

  O número máximo de resultados a serem retornados.

• Filter – Um objeto TransformFilterCriteria.

  Os critérios da transformação de filtros

• Sort – Um objeto TransformSortCriteria.

  Os critérios de classificação.

Resposta

• Transforms – Obrigatório: uma matriz de objetos MLTransform.

  Uma lista de transformações de machine learning.

• NextToken – String UTF-8.

  Um token de paginação, se houver mais resultados disponíveis.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Solicitação

• 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.

• Filter – Um objeto TransformFilterCriteria.

  Os TransformFilterCriteria usados para filtrar as transformações de machine learning.

• Sort – Um objeto TransformSortCriteria.

  Os TransformSortCriteria usados para classificar as transformações de machine learning.

• 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.

  Especifica apenas o retorno desses recursos com tags.

Resposta

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

  Os identificadores de todas as transformações de machine learning na conta, ou as transformações de machine learning com as tags especificadas.

• NextToken – String UTF-8.

  Um token de continuação, se a lista retornada não contiver a métrica mais recente disponível.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Solicitação

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

  O identificador exclusivo da transformação de machine learning.

Resposta

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

  O identificador exclusivo associado a essa execução.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• ConcurrentRunsExceededException

• MLTransformNotReadyException

Solicitação

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

  O identificador exclusivo da transformação de machine learning.

• OutputS3Path – Obrigatório: string UTF-8.

  O caminho do Amazon Simple Storage Service (Amazon S3) de onde você gera o conjunto de rótulos.

Resposta

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

  O identificador exclusivo da execução associado a essa execução de tarefa.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• ConcurrentRunsExceededException

Solicitação

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

  O identificador exclusivo da transformação de machine learning.

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

  O identificador exclusivo da tarefa executada.

Resposta

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

  O identificador exclusivo da tarefa executada.

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

  O identificador de execução único associado a essa execução.

• Status – String UTF-8 (valores válidos: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT).

  O status da execução dessa tarefa.

• LogGroupName – String UTF-8.

  Os nomes dos grupos de logs associados à execução de tarefa.

• Properties – Um objeto TaskRunProperties.

  A lista de propriedades associadas à execução de tarefa.

• ErrorString – String UTF-8.

  As strings de erro associadas à execução de tarefa.

• StartedOn – Timestamp.

  A data e hora em que essa execução de tarefa foi iniciada.

• LastModifiedOn – Timestamp.

  A data e hora em que essa execução de tarefa foi modificada pela última vez.

• CompletedOn – Timestamp.

  A data e hora em que essa execução de tarefa foi finalizada.

• ExecutionTime – Número (íntegro).

  A quantidade de tempo (em segundos) em que a tarefa executada consumiu recursos.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Solicitação

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

  O identificador exclusivo da transformação de machine learning.

• NextToken – String UTF-8.

  Um token de paginação dos resultados. O padrão é vazio.

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

  O número máximo de resultados a serem retornados.

• Filter – Um objeto TaskRunFilterCriteria.

  Os critérios de filtro, na estrutura TaskRunFilterCriteria, da execução de tarefa.

• Sort – Um objeto TaskRunSortCriteria.

  Os critérios de classificação, na estrutura TaskRunSortCriteria, da execução de tarefa.

Resposta

• TaskRuns – Uma matriz de objetos TaskRun.

  Uma lista de execuções de tarefa que são associadas a transformação.

• NextToken – String UTF-8.

  Um token de paginação, se houver mais resultados disponíveis.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Solicitação

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

  O identificador exclusivo da transformação de machine learning.

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

  Um identificador exclusivo para a tarefa executada.

Resposta

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

  O identificador exclusivo da transformação de machine learning.

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

  O identificador exclusivo da tarefa executada.

• Status – String UTF-8 (valores válidos: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT).

  O status dessa execução.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Solicitação

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

  O identificador exclusivo da transformação de machine learning.

• OutputS3Path – Obrigatório: string UTF-8.

  O caminho do Amazon S3 para onde você exportará os rótulos.

Resposta

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

  O identificador exclusivo da tarefa executada.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

Solicitação

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

  O identificador exclusivo da transformação de machine learning.

• InputS3Path – Obrigatório: string UTF-8.

  O caminho do Amazon Simple Storage Service (Amazon S3) para onde você importará os rótulos.

• ReplaceAllLabels – Booleano.

  Indica se você deve substituir os rótulos existentes.

Resposta

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

  O identificador exclusivo da tarefa executada.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• ResourceNumberLimitExceededException

• InternalServiceException