/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
/*
* Do not modify this file. This file is generated from the glue-2017-03-31.normal.json service model.
*/
using System;
using System.Collections.Generic;
using System.Xml.Serialization;
using System.Text;
using System.IO;
using System.Net;
using Amazon.Runtime;
using Amazon.Runtime.Internal;
namespace Amazon.Glue.Model
{
///
/// Specifies information used to update an existing job definition. The previous job
/// definition is completely overwritten by this information.
///
public partial class JobUpdate
{
private int? _allocatedCapacity;
private Dictionary _codeGenConfigurationNodes = new Dictionary();
private JobCommand _command;
private ConnectionsList _connections;
private Dictionary _defaultArguments = new Dictionary();
private string _description;
private ExecutionClass _executionClass;
private ExecutionProperty _executionProperty;
private string _glueVersion;
private string _logUri;
private double? _maxCapacity;
private int? _maxRetries;
private Dictionary _nonOverridableArguments = new Dictionary();
private NotificationProperty _notificationProperty;
private int? _numberOfWorkers;
private string _role;
private string _securityConfiguration;
private SourceControlDetails _sourceControlDetails;
private int? _timeout;
private WorkerType _workerType;
///
/// Gets and sets the property AllocatedCapacity.
///
/// This field is deprecated. Use MaxCapacity
instead.
///
///
///
/// The number of Glue data processing units (DPUs) to allocate to this job. You can allocate
/// a minimum of 2 DPUs; the default is 10. A DPU is a relative measure of processing
/// power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information,
/// see the Glue pricing page.
///
///
[Obsolete("This property is deprecated, use MaxCapacity instead.")]
public int AllocatedCapacity
{
get { return this._allocatedCapacity.GetValueOrDefault(); }
set { this._allocatedCapacity = value; }
}
// Check to see if AllocatedCapacity property is set
internal bool IsSetAllocatedCapacity()
{
return this._allocatedCapacity.HasValue;
}
///
/// Gets and sets the property CodeGenConfigurationNodes.
///
/// The representation of a directed acyclic graph on which both the Glue Studio visual
/// component and Glue Studio code generation is based.
///
///
[AWSProperty(Sensitive=true)]
public Dictionary CodeGenConfigurationNodes
{
get { return this._codeGenConfigurationNodes; }
set { this._codeGenConfigurationNodes = value; }
}
// Check to see if CodeGenConfigurationNodes property is set
internal bool IsSetCodeGenConfigurationNodes()
{
return this._codeGenConfigurationNodes != null && this._codeGenConfigurationNodes.Count > 0;
}
///
/// Gets and sets the property Command.
///
/// The JobCommand
that runs this job (required).
///
///
public JobCommand Command
{
get { return this._command; }
set { this._command = value; }
}
// Check to see if Command property is set
internal bool IsSetCommand()
{
return this._command != null;
}
///
/// Gets and sets the property Connections.
///
/// The connections used for this job.
///
///
public ConnectionsList Connections
{
get { return this._connections; }
set { this._connections = value; }
}
// Check to see if Connections property is set
internal bool IsSetConnections()
{
return this._connections != null;
}
///
/// Gets and sets the property DefaultArguments.
///
/// The default arguments for every run of this job, specified as name-value pairs.
///
///
///
/// You can specify arguments here that your own job-execution script consumes, as well
/// as arguments that Glue itself consumes.
///
///
///
/// Job arguments may be logged. Do not pass plaintext secrets as arguments. Retrieve
/// secrets from a Glue Connection, Secrets Manager or other secret management mechanism
/// if you intend to keep them within the Job.
///
///
///
/// For information about how to specify and consume your own Job arguments, see the Calling
/// Glue APIs in Python topic in the developer guide.
///
///
///
/// For information about the arguments you can provide to this field when configuring
/// Spark jobs, see the Special
/// Parameters Used by Glue topic in the developer guide.
///
///
///
/// For information about the arguments you can provide to this field when configuring
/// Ray jobs, see Using
/// job parameters in Ray jobs in the developer guide.
///
///
public Dictionary DefaultArguments
{
get { return this._defaultArguments; }
set { this._defaultArguments = value; }
}
// Check to see if DefaultArguments property is set
internal bool IsSetDefaultArguments()
{
return this._defaultArguments != null && this._defaultArguments.Count > 0;
}
///
/// Gets and sets the property Description.
///
/// Description of the job being defined.
///
///
[AWSProperty(Min=0, Max=2048)]
public string Description
{
get { return this._description; }
set { this._description = value; }
}
// Check to see if Description property is set
internal bool IsSetDescription()
{
return this._description != null;
}
///
/// Gets and sets the property ExecutionClass.
///
/// Indicates whether the job is run with a standard or flexible execution class. The
/// standard execution-class is ideal for time-sensitive workloads that require fast job
/// startup and dedicated resources.
///
///
///
/// The flexible execution class is appropriate for time-insensitive jobs whose start
/// and completion times may vary.
///
///
///
/// Only jobs with Glue version 3.0 and above and command type glueetl
will
/// be allowed to set ExecutionClass
to FLEX
. The flexible execution
/// class is available for Spark jobs.
///
///
[AWSProperty(Max=16)]
public ExecutionClass ExecutionClass
{
get { return this._executionClass; }
set { this._executionClass = value; }
}
// Check to see if ExecutionClass property is set
internal bool IsSetExecutionClass()
{
return this._executionClass != null;
}
///
/// Gets and sets the property ExecutionProperty.
///
/// An ExecutionProperty
specifying the maximum number of concurrent runs
/// allowed for this job.
///
///
public ExecutionProperty ExecutionProperty
{
get { return this._executionProperty; }
set { this._executionProperty = value; }
}
// Check to see if ExecutionProperty property is set
internal bool IsSetExecutionProperty()
{
return this._executionProperty != null;
}
///
/// Gets and sets the property GlueVersion.
///
/// In Spark jobs, GlueVersion
determines the versions of Apache Spark and
/// Python that Glue available in a job. The Python version indicates the version supported
/// for jobs of type Spark.
///
///
///
/// Ray jobs should set GlueVersion
to 4.0
or greater. However,
/// the versions of Ray, Python and additional libraries available in your Ray job are
/// determined by the Runtime
parameter of the Job command.
///
///
///
/// For more information about the available Glue versions and corresponding Spark and
/// Python versions, see Glue
/// version in the developer guide.
///
///
///
/// Jobs that are created without specifying a Glue version default to Glue 0.9.
///
///
[AWSProperty(Min=1, Max=255)]
public string GlueVersion
{
get { return this._glueVersion; }
set { this._glueVersion = value; }
}
// Check to see if GlueVersion property is set
internal bool IsSetGlueVersion()
{
return this._glueVersion != null;
}
///
/// Gets and sets the property LogUri.
///
/// This field is reserved for future use.
///
///
public string LogUri
{
get { return this._logUri; }
set { this._logUri = value; }
}
// Check to see if LogUri property is set
internal bool IsSetLogUri()
{
return this._logUri != null;
}
///
/// Gets and sets the property MaxCapacity.
///
/// For Glue version 1.0 or earlier jobs, using the standard worker type, the number of
/// Glue data processing units (DPUs) that can be allocated when this job runs. A DPU
/// is a relative measure of processing power that consists of 4 vCPUs of compute capacity
/// and 16 GB of memory. For more information, see the
/// Glue pricing page.
///
///
///
/// For Glue version 2.0+ jobs, you cannot specify a Maximum capacity
. Instead,
/// you should specify a Worker type
and the Number of workers
.
///
///
///
/// Do not set MaxCapacity
if using WorkerType
and NumberOfWorkers
.
///
///
///
/// The value that can be allocated for MaxCapacity
depends on whether you
/// are running a Python shell job, an Apache Spark ETL job, or an Apache Spark streaming
/// ETL job:
///
/// -
///
/// When you specify a Python shell job (
JobCommand.Name
="pythonshell"),
/// you can allocate either 0.0625 or 1 DPU. The default is 0.0625 DPU.
///
/// -
///
/// When you specify an Apache Spark ETL job (
JobCommand.Name
="glueetl")
/// or Apache Spark streaming ETL job (JobCommand.Name
="gluestreaming"),
/// you can allocate from 2 to 100 DPUs. The default is 10 DPUs. This job type cannot
/// have a fractional DPU allocation.
///
///
///
public double MaxCapacity
{
get { return this._maxCapacity.GetValueOrDefault(); }
set { this._maxCapacity = value; }
}
// Check to see if MaxCapacity property is set
internal bool IsSetMaxCapacity()
{
return this._maxCapacity.HasValue;
}
///
/// Gets and sets the property MaxRetries.
///
/// The maximum number of times to retry this job if it fails.
///
///
public int MaxRetries
{
get { return this._maxRetries.GetValueOrDefault(); }
set { this._maxRetries = value; }
}
// Check to see if MaxRetries property is set
internal bool IsSetMaxRetries()
{
return this._maxRetries.HasValue;
}
///
/// Gets and sets the property NonOverridableArguments.
///
/// Arguments for this job that are not overridden when providing job arguments in a job
/// run, specified as name-value pairs.
///
///
public Dictionary NonOverridableArguments
{
get { return this._nonOverridableArguments; }
set { this._nonOverridableArguments = value; }
}
// Check to see if NonOverridableArguments property is set
internal bool IsSetNonOverridableArguments()
{
return this._nonOverridableArguments != null && this._nonOverridableArguments.Count > 0;
}
///
/// Gets and sets the property NotificationProperty.
///
/// Specifies the configuration properties of a job notification.
///
///
public NotificationProperty NotificationProperty
{
get { return this._notificationProperty; }
set { this._notificationProperty = value; }
}
// Check to see if NotificationProperty property is set
internal bool IsSetNotificationProperty()
{
return this._notificationProperty != null;
}
///
/// Gets and sets the property NumberOfWorkers.
///
/// The number of workers of a defined workerType
that are allocated when
/// a job runs.
///
///
public int NumberOfWorkers
{
get { return this._numberOfWorkers.GetValueOrDefault(); }
set { this._numberOfWorkers = value; }
}
// Check to see if NumberOfWorkers property is set
internal bool IsSetNumberOfWorkers()
{
return this._numberOfWorkers.HasValue;
}
///
/// Gets and sets the property Role.
///
/// The name or Amazon Resource Name (ARN) of the IAM role associated with this job (required).
///
///
public string Role
{
get { return this._role; }
set { this._role = value; }
}
// Check to see if Role property is set
internal bool IsSetRole()
{
return this._role != null;
}
///
/// Gets and sets the property SecurityConfiguration.
///
/// The name of the SecurityConfiguration
structure to be used with this
/// job.
///
///
[AWSProperty(Min=1, Max=255)]
public string SecurityConfiguration
{
get { return this._securityConfiguration; }
set { this._securityConfiguration = value; }
}
// Check to see if SecurityConfiguration property is set
internal bool IsSetSecurityConfiguration()
{
return this._securityConfiguration != null;
}
///
/// Gets and sets the property SourceControlDetails.
///
/// The details for a source control configuration for a job, allowing synchronization
/// of job artifacts to or from a remote repository.
///
///
public SourceControlDetails SourceControlDetails
{
get { return this._sourceControlDetails; }
set { this._sourceControlDetails = value; }
}
// Check to see if SourceControlDetails property is set
internal bool IsSetSourceControlDetails()
{
return this._sourceControlDetails != null;
}
///
/// Gets and sets the property Timeout.
///
/// The job timeout in minutes. This is the maximum time that a job run can consume resources
/// before it is terminated and enters TIMEOUT
status. The default is 2,880
/// minutes (48 hours).
///
///
[AWSProperty(Min=1)]
public int Timeout
{
get { return this._timeout.GetValueOrDefault(); }
set { this._timeout = value; }
}
// Check to see if Timeout property is set
internal bool IsSetTimeout()
{
return this._timeout.HasValue;
}
///
/// Gets and sets the property WorkerType.
///
/// The type of predefined worker that is allocated when a job runs. Accepts a value of
/// G.1X, G.2X, G.4X, G.8X or G.025X for Spark jobs. Accepts the value Z.2X for Ray jobs.
///
/// -
///
/// For the
G.1X
worker type, each worker maps to 1 DPU (4 vCPUs, 16 GB of
/// memory) with 84GB disk (approximately 34GB free), and provides 1 executor per worker.
/// We recommend this worker type for workloads such as data transforms, joins, and queries,
/// to offers a scalable and cost effective way to run most jobs.
///
/// -
///
/// For the
G.2X
worker type, each worker maps to 2 DPU (8 vCPUs, 32 GB of
/// memory) with 128GB disk (approximately 77GB free), and provides 1 executor per worker.
/// We recommend this worker type for workloads such as data transforms, joins, and queries,
/// to offers a scalable and cost effective way to run most jobs.
///
/// -
///
/// For the
G.4X
worker type, each worker maps to 4 DPU (16 vCPUs, 64 GB
/// of memory) with 256GB disk (approximately 235GB free), and provides 1 executor per
/// worker. We recommend this worker type for jobs whose workloads contain your most demanding
/// transforms, aggregations, joins, and queries. This worker type is available only for
/// Glue version 3.0 or later Spark ETL jobs in the following Amazon Web Services Regions:
/// US East (Ohio), US East (N. Virginia), US West (Oregon), Asia Pacific (Singapore),
/// Asia Pacific (Sydney), Asia Pacific (Tokyo), Canada (Central), Europe (Frankfurt),
/// Europe (Ireland), and Europe (Stockholm).
///
/// -
///
/// For the
G.8X
worker type, each worker maps to 8 DPU (32 vCPUs, 128 GB
/// of memory) with 512GB disk (approximately 487GB free), and provides 1 executor per
/// worker. We recommend this worker type for jobs whose workloads contain your most demanding
/// transforms, aggregations, joins, and queries. This worker type is available only for
/// Glue version 3.0 or later Spark ETL jobs, in the same Amazon Web Services Regions
/// as supported for the G.4X
worker type.
///
/// -
///
/// For the
G.025X
worker type, each worker maps to 0.25 DPU (2 vCPUs, 4
/// GB of memory) with 84GB disk (approximately 34GB free), and provides 1 executor per
/// worker. We recommend this worker type for low volume streaming jobs. This worker type
/// is only available for Glue version 3.0 streaming jobs.
///
/// -
///
/// For the
Z.2X
worker type, each worker maps to 2 M-DPU (8vCPUs, 64 GB
/// of memory) with 128 GB disk (approximately 120GB free), and provides up to 8 Ray workers
/// based on the autoscaler.
///
///
///
public WorkerType WorkerType
{
get { return this._workerType; }
set { this._workerType = value; }
}
// Check to see if WorkerType property is set
internal bool IsSetWorkerType()
{
return this._workerType != null;
}
}
}