registerJobDefinition method

Future<RegisterJobDefinitionResponse> registerJobDefinition({
  1. required String jobDefinitionName,
  2. required JobDefinitionType type,
  3. ContainerProperties? containerProperties,
  4. NodeProperties? nodeProperties,
  5. Map<String, String>? parameters,
  6. List<PlatformCapability>? platformCapabilities,
  7. bool? propagateTags,
  8. RetryStrategy? retryStrategy,
  9. Map<String, String>? tags,
  10. JobTimeout? timeout,
})

Registers an AWS Batch job definition.

May throw ClientException. May throw ServerException.

Parameter jobDefinitionName : The name of the job definition to register. Up to 128 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.

Parameter type : The type of job definition. For more information about multi-node parallel jobs, see Creating a multi-node parallel job definition in the AWS Batch User Guide.

Parameter containerProperties : An object with various properties specific to single-node container-based jobs. If the job definition's type parameter is container, then you must specify either containerProperties or nodeProperties.

Parameter nodeProperties : An object with various properties specific to multi-node parallel jobs. If you specify node properties for a job, it becomes a multi-node parallel job. For more information, see Multi-node Parallel Jobs in the AWS Batch User Guide. If the job definition's type parameter is container, then you must specify either containerProperties or nodeProperties.

Parameter parameters : Default parameter substitution placeholders to set in the job definition. Parameters are specified as a key-value pair mapping. Parameters in a SubmitJob request override any corresponding parameter defaults from the job definition.

Parameter platformCapabilities : The platform capabilities required by the job definition. If no value is specified, it defaults to EC2. To run the job on Fargate resources, specify FARGATE.

Parameter propagateTags : Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task. If no value is specified, the tags are not propagated. Tags can only be propagated to the tasks during task creation. For tags with the same name, job tags are given priority over job definitions tags. If the total number of combined tags from the job and job definition is over 50, the job is moved to the FAILED state.

Parameter retryStrategy : The retry strategy to use for failed jobs that are submitted with this job definition. Any retry strategy that's specified during a SubmitJob operation overrides the retry strategy defined here. If a job is terminated due to a timeout, it isn't retried.

Parameter tags : The tags that you apply to the job definition to help you categorize and organize your resources. Each tag consists of a key and an optional value. For more information, see Tagging AWS Resources in AWS Batch User Guide.

Parameter timeout : The timeout configuration for jobs that are submitted with this job definition, after which AWS Batch terminates your jobs if they have not finished. If a job is terminated due to a timeout, it isn't retried. The minimum value for the timeout is 60 seconds. Any timeout configuration that's specified during a SubmitJob operation overrides the timeout configuration defined here. For more information, see Job Timeouts in the AWS Batch User Guide.

Implementation

Future<RegisterJobDefinitionResponse> registerJobDefinition({
  required String jobDefinitionName,
  required JobDefinitionType type,
  ContainerProperties? containerProperties,
  NodeProperties? nodeProperties,
  Map<String, String>? parameters,
  List<PlatformCapability>? platformCapabilities,
  bool? propagateTags,
  RetryStrategy? retryStrategy,
  Map<String, String>? tags,
  JobTimeout? timeout,
}) async {
  ArgumentError.checkNotNull(jobDefinitionName, 'jobDefinitionName');
  ArgumentError.checkNotNull(type, 'type');
  final $payload = <String, dynamic>{
    'jobDefinitionName': jobDefinitionName,
    'type': type.toValue(),
    if (containerProperties != null)
      'containerProperties': containerProperties,
    if (nodeProperties != null) 'nodeProperties': nodeProperties,
    if (parameters != null) 'parameters': parameters,
    if (platformCapabilities != null)
      'platformCapabilities':
          platformCapabilities.map((e) => e.toValue()).toList(),
    if (propagateTags != null) 'propagateTags': propagateTags,
    if (retryStrategy != null) 'retryStrategy': retryStrategy,
    if (tags != null) 'tags': tags,
    if (timeout != null) 'timeout': timeout,
  };
  final response = await _protocol.send(
    payload: $payload,
    method: 'POST',
    requestUri: '/v1/registerjobdefinition',
    exceptionFnMap: _exceptionFns,
  );
  return RegisterJobDefinitionResponse.fromJson(response);
}