Skip to content

Job

This class encapsulates and extends the ROS resource type ALIYUN::PAIDLC::Job, which is used to create a Machine Learning Platform for AI (PAI) job to run in a cluster.

Initializers

import com.aliyun.ros.cdk.paidlc.Job;
Job.Builder.create(Construct scope, java.lang.String id, java.lang.Boolean enableResourcePropertyConstraint)
    .displayName(java.lang.String)
    .displayName(IResolvable)
    .jobSpecs(IResolvable)
    .jobSpecs(java.util.List<IResolvable)
    .jobSpecs(JobSpecsProperty>)
    .jobType(java.lang.String)
    .jobType(IResolvable)
    .userCommand(java.lang.String)
    .userCommand(IResolvable)
    .workspaceId(java.lang.String)
    .workspaceId(IResolvable)
//  .codeSource(IResolvable)
//  .codeSource(CodeSourceProperty)
//  .dataSources(IResolvable)
//  .dataSources(java.util.List<IResolvable)
//  .dataSources(DataSourcesProperty>)
//  .envs(java.lang.String)
//  .envs(IResolvable)
//  .jobMaxRunningTimeMinutes(java.lang.Number)
//  .jobMaxRunningTimeMinutes(IResolvable)
//  .options(java.lang.String)
//  .options(IResolvable)
//  .priority(java.lang.Number)
//  .priority(IResolvable)
//  .resourceId(java.lang.String)
//  .resourceId(IResolvable)
//  .settings(IResolvable)
//  .settings(java.util.Map<java.lang.String, java.lang.Object>)
//  .successPolicy(java.lang.String)
//  .successPolicy(IResolvable)
//  .thirdpartyLibDir(java.lang.String)
//  .thirdpartyLibDir(IResolvable)
//  .thirdpartyLibs(IResolvable)
//  .thirdpartyLibs(java.util.List<java.lang.String)
//  .thirdpartyLibs(IResolvable>)
//  .userVpc(IResolvable)
//  .userVpc(UserVpcProperty)
    .build();
Name Type Description
scope com.aliyun.ros.cdk.core.Construct No description.
id java.lang.String No description.
enableResourcePropertyConstraint java.lang.Boolean No description.
displayName java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property displayName: The name of the task is as follows: The name length does not exceed 256 characters.
jobSpecs com.aliyun.ros.cdk.core.IResolvable OR java.util.ListJobSpecsProperty> Property jobSpecs: Jobspecs describes various configurations of tasks during the mission, such as mirror address, start command, node resource statement, number of copies, etc.
jobType java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property jobType: The type of job.
userCommand java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property userCommand: Start commands of all nodes in the task.
workspaceId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property workspaceId: Work space ID, how to get working space ID, see listworkSpaces.
codeSource com.aliyun.ros.cdk.core.IResolvable OR CodeSourceProperty Property codeSource: The code source used in this task.Before the mission node starts, the DLC will automatically download the code configured in the code source, and mount to the local directory of the container.
dataSources com.aliyun.ros.cdk.core.IResolvable OR java.util.ListDataSourcesProperty> Property dataSources: List of data source used for task operation.
envs java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property envs: Environment variable configuration.
jobMaxRunningTimeMinutes java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property jobMaxRunningTimeMinutes: The longest running time is running, and the unit is minutes.
options java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property options: The additional configuration of this task can adjust some of the behavior of the mounting data source through this parameter.If the task has a data source that mounted the OSS type, you can cover the default parameters of the jinofs by configure the configuration of this parameter to fs.OSS.DOWNLOAD.CONCURRENCY = 4, fs.oss.download.queue.size = 16.
priority java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property priority: The priority of the task, optional parameter, default value 1, the range of parameter values is 1 ~ 9.in: 1 is the minimum priority. 9 is the highest priority.
resourceId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property resourceId: Resource group ID, optional parameter.
settings com.aliyun.ros.cdk.core.IResolvable OR java.util.Map Property settings: Job settings.
successPolicy java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property successPolicy: The successful strategy of distributed multi -machine tasks is currently only supported by TensorFlow's multi -machine task.
thirdpartyLibDir java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property thirdpartyLibDir: The name folder of the Requirements.txt file is located; before each node runs the specified usercommand, PAI -DLC will take the requirements.txt file from the specified folder and call the PIP Install -R installation.
thirdpartyLibs com.aliyun.ros.cdk.core.IResolvable OR java.util.List Property thirdpartyLibs: Python third-party library list to be installed.
userVpc com.aliyun.ros.cdk.core.IResolvable OR UserVpcProperty Property userVpc: User VPC configuration.

scopeRequired

  • Type: com.aliyun.ros.cdk.core.Construct

idRequired

  • Type: java.lang.String

enableResourcePropertyConstraintOptional

  • Type: java.lang.Boolean

displayNameRequired

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property displayName: The name of the task is as follows: The name length does not exceed 256 characters.

Allow numbers, letters, lower strokes (_), English period (.) And short horizontal lines (-).


jobSpecsRequired

  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.ListJobSpecsProperty>

Property jobSpecs: Jobspecs describes various configurations of tasks during the mission, such as mirror address, start command, node resource statement, number of copies, etc.

The DLC task consists of different types of nodes. The same type of nodes have exactly the same configuration. This configuration is called a Jobspec. Jobspecs describes the configuration of all types of nodes and is the array of Jobspec.


jobTypeRequired

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property jobType: The type of job.

Values: TFJob, PyTorchJob, XGBoostJob, OneFlowJob, ElasticBatch


userCommandRequired

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property userCommand: Start commands of all nodes in the task.


workspaceIdRequired

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property workspaceId: Work space ID, how to get working space ID, see listworkSpaces.


codeSourceOptional

Property codeSource: The code source used in this task.Before the mission node starts, the DLC will automatically download the code configured in the code source, and mount to the local directory of the container.


dataSourcesOptional

  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.ListDataSourcesProperty>

Property dataSources: List of data source used for task operation.


envsOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property envs: Environment variable configuration.


jobMaxRunningTimeMinutesOptional

  • Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property jobMaxRunningTimeMinutes: The longest running time is running, and the unit is minutes.


optionsOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property options: The additional configuration of this task can adjust some of the behavior of the mounting data source through this parameter.If the task has a data source that mounted the OSS type, you can cover the default parameters of the jinofs by configure the configuration of this parameter to fs.OSS.DOWNLOAD.CONCURRENCY = 4, fs.oss.download.queue.size = 16.


priorityOptional

  • Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property priority: The priority of the task, optional parameter, default value 1, the range of parameter values is 1 ~ 9.in: 1 is the minimum priority. 9 is the highest priority.


resourceIdOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property resourceId: Resource group ID, optional parameter.

The parameter value is empty indicating that submitted to the public resource group. If the current working space has been bound to a proprietary resource group, you can specify the corresponding resource group ID here; how to create a proprietary resource group and inquire about the proprietary resource group ID, please refer to the preparation and management of the DLC resource group cluster.


settingsOptional

  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.Map

Property settings: Job settings.


successPolicyOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property successPolicy: The successful strategy of distributed multi -machine tasks is currently only supported by TensorFlow's multi -machine task.

ChiefWorker: When it is specified as this value, as long as the Chief's POD is successful, it is considered that the entire task is successful. All workers: All workers must be successful to think that the entire task is successful.


thirdpartyLibDirOptional

  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property thirdpartyLibDir: The name folder of the Requirements.txt file is located; before each node runs the specified usercommand, PAI -DLC will take the requirements.txt file from the specified folder and call the PIP Install -R installation.


thirdpartyLibsOptional

  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property thirdpartyLibs: Python third-party library list to be installed.


userVpcOptional

Property userVpc: User VPC configuration.


Methods

Name Description
toString Returns a string representation of this construct.
synthesize Allows this construct to emit artifacts into the cloud assembly during synthesis.
addCondition No description.
addCount No description.
addDependency No description.
addResourceDesc No description.
applyRemovalPolicy No description.
getAtt No description.
setMetadata No description.

toString

public java.lang.String toString()

Returns a string representation of this construct.

synthesize

public void synthesize(ISynthesisSession session)

Allows this construct to emit artifacts into the cloud assembly during synthesis.

This method is usually implemented by framework-level constructs such as Stack and Asset as they participate in synthesizing the cloud assembly.

sessionRequired

  • Type: com.aliyun.ros.cdk.core.ISynthesisSession

The synthesis session.


addCondition

public void addCondition(RosCondition condition)

conditionRequired

  • Type: com.aliyun.ros.cdk.core.RosCondition

addCount

public void addCount(java.lang.Number OR IResolvable count)

countRequired

  • Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

addDependency

public void addDependency(Resource resource)

resourceRequired

  • Type: com.aliyun.ros.cdk.core.Resource

addResourceDesc

public void addResourceDesc(java.lang.String desc)

descRequired

  • Type: java.lang.String

applyRemovalPolicy

public void applyRemovalPolicy(RemovalPolicy policy)

policyRequired

  • Type: com.aliyun.ros.cdk.core.RemovalPolicy

getAtt

public IResolvable getAtt(java.lang.String name)

nameRequired

  • Type: java.lang.String

setMetadata

public void setMetadata(java.lang.String key, java.lang.Object value)

keyRequired

  • Type: java.lang.String

valueRequired

  • Type: java.lang.Object

Static Functions

Name Description
isConstruct Return whether the given object is a Construct.

isConstruct

import com.aliyun.ros.cdk.paidlc.Job;
Job.isConstruct(java.lang.Object x)

Return whether the given object is a Construct.

xRequired

  • Type: java.lang.Object

Properties

Name Type Description
node com.aliyun.ros.cdk.core.ConstructNode The construct tree node associated with this construct.
ref java.lang.String No description.
stack com.aliyun.ros.cdk.core.Stack The stack in which this resource is defined.
resource com.aliyun.ros.cdk.core.RosResource No description.
attrJobId com.aliyun.ros.cdk.core.IResolvable Attribute JobId: The task ID created this time.

nodeRequired

public ConstructNode getNode();
  • Type: com.aliyun.ros.cdk.core.ConstructNode

The construct tree node associated with this construct.


refRequired

public java.lang.String getRef();
  • Type: java.lang.String

stackRequired

public Stack getStack();
  • Type: com.aliyun.ros.cdk.core.Stack

The stack in which this resource is defined.


resourceOptional

public RosResource getResource();
  • Type: com.aliyun.ros.cdk.core.RosResource

attrJobIdRequired

public IResolvable getAttrJobId();
  • Type: com.aliyun.ros.cdk.core.IResolvable

Attribute JobId: The task ID created this time.