Data Types

Last updated: 2020-01-17 10:45:15

Activity

Compute environment creation or termination activities

Used by actions: DescribeComputeEnvActivities.

Name Type Description
ActivityId String Activity ID
ComputeNodeId String Compute node ID
ComputeNodeActivityType String Compute node activity type: creation or termination
EnvId String Compute environment ID
Cause String Cause
ActivityState String Active status
StateReason String State reason
StartTime String Activity start time
EndTime String Activity end time
Note: This field may return null, indicating that no valid values can be obtained.
InstanceId String CVM instance ID
Note: This field may return null, indicating that no valid values can be obtained.

AgentRunningMode

Agent running mode

Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

Name Type Required Description
Scene String Yes Scenario type. Windows is supported
User String Yes The user that runs the Agent
Session String Yes The session that runs the Agent

AnonymousComputeEnv

Compute environment

Used by actions: CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

Name Type Required Description
EnvType String No Compute environment management type
EnvData EnvData No Compute environment's specific parameters
MountDataDisks Array of MountDataDisk No Data disk mounting option
AgentRunningMode AgentRunningMode No Agent running mode; applicable for Windows

Application

Application information

Used by actions: CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

Name Type Required Description
Command String Yes Task execution command
DeliveryForm String Yes Delivery form of the application. Value range: PACKAGE, LOCAL, which refer to remotely stored software package and local compute environment, respectively.
PackagePath String No Remote storage path of the application package
Docker Docker No Relevant configuration of the Docker used by the application. In case that the Docker configuration is used, "LOCAL" DeliveryForm means that the application software inside the Docker image is used directly and run in Docker mode; "PACKAGE" DeliveryForm means that the remote application package is run in Docker mode after being injected into the Docker image. To avoid compatibility issues with different versions of Docker, the Docker installation package and relevant dependencies are taken care of by BatchCompute. For custom images where Docker has already been installed, uninstall Docker first and then use the Docker feature.

Authentication

Authentication information

Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

Name Type Required Description
Scene String Yes Authentication scenario such as COS
SecretId String Yes SecretId
SecretKey String Yes SecretKey

ComputeEnvCreateInfo

Compute environment creation information

Used by actions: DescribeComputeEnvCreateInfos.

Name Type Description
EnvId String Compute environment ID
EnvName String Compute environment name
Note: This field may return null, indicating that no valid values can be obtained.
EnvDescription String Compute environment description
Note: This field may return null, indicating that no valid values can be obtained.
EnvType String Compute environment type. Only "MANAGED" type is supported
EnvData EnvData Compute environment parameter
MountDataDisks Array of MountDataDisk Data disk mounting option
Note: This field may return null, indicating that no valid values can be obtained.
InputMappings Array of InputMapping Input mapping
Note: This field may return null, indicating that no valid values can be obtained.
Authentications Array of Authentication Authorization information
Note: This field may return null, indicating that no valid values can be obtained.
Notifications Array of Notification Notification information
Note: This field may return null, indicating that no valid values can be obtained.
DesiredComputeNodeCount Integer Number of desired compute nodes

ComputeEnvData

Compute environment attributes

Used by actions: ModifyComputeEnv.

Name Type Required Description
InstanceTypes Array of String Yes List of CVM instance types

ComputeEnvView

Compute environment information

Used by actions: DescribeComputeEnvs.

Name Type Description
EnvId String Compute environment ID
EnvName String Compute environment name
Placement Placement Location information
CreateTime String Creation time
ComputeNodeMetrics ComputeNodeMetrics Compute node statistical metrics
EnvType String Compute environment type
DesiredComputeNodeCount Integer Number of desired compute nodes

ComputeNode

Compute node

Used by actions: DescribeComputeEnv.

Name Type Description
ComputeNodeId String Compute node ID
ComputeNodeInstanceId String Compute node instance ID. In a CVM scenario, this parameter is the CVM InstanceId
ComputeNodeState String Compute node state
Cpu Integer Number of CPU cores
Mem Integer Memory size in GiB
ResourceCreatedTime String Resource creation time
TaskInstanceNumAvailable Integer Available capacity of the compute node when running TaskInstance. 0 means that the compute node is busy.
AgentVersion String BatchCompute Agent version
PrivateIpAddresses Array of String Private IP of the instance
PublicIpAddresses Array of String Public IP of the instance

ComputeNodeMetrics

Compute node statistical metrics

Used by actions: DescribeComputeEnv、DescribeComputeEnvs.

Name Type Description
SubmittedCount Integer Number of compute nodes that have been submitted
CreatingCount Integer Number of compute nodes that are being created
CreationFailedCount Integer Number of compute nodes that failed to be created
CreatedCount Integer Number of compute nodes that have been created
RunningCount Integer Number of running compute nodes
DeletingCount Integer Number of compute nodes that are being terminated
AbnormalCount Integer Number of exceptional compute nodes

DataDisk

Describes data disk information.

Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

Name Type Required Description
DiskSize Integer Yes The data disk size in GB. The minimum increment is 10 GB. Different types of data disks have different value ranges. For details, see Instance Specifications. The default value is 0, indicating that no data disk is purchased. For more information, see the CVM documentation.
DiskType String No The data disk type. For more information about the limits on different data disk types, see Instance Specifications. Valid values:
  • LOCAL_BASIC: local disk
  • LOCAL_SSD: local SSD disk
  • CLOUD_BASIC: HDD cloud disk
  • CLOUD_PREMIUM: premium cloud storage
  • CLOUD_SSD: SSD cloud disk

    Default value: LOCAL_BASIC.

    This parameter is invalid for the ResizeInstanceDisk API.
  • DiskId String No Data disk ID. Data disks whose type is LOCAL_BASIC or LOCAL_SSD do not have an ID and do not support this parameter currently.
    DeleteWithInstance Boolean No Whether to terminate the data disk when its CVM is terminated. Valid values:
  • TRUE: terminate the data disk when its CVM is terminated. This value only supports pay-as-you-go cloud disks billed on an hourly basis.
  • FALSE: retain the data disk when its CVM is terminated.

    Default value: TRUE

    Currently this parameter is only used in the RunInstances API.
    Note: This field may return null, indicating that no valid value is found.
  • SnapshotId String No Data disk snapshot ID. The size of the selected data disk snapshot must be smaller than that of the data disk.
    Note: This field may return null, indicating that no valid value is found.

    Dependence

    Dependency

    Used by actions: DescribeJob、DescribeJobSubmitInfo、SubmitJob.

    Name Type Required Description
    StartTask String Yes Dependency start task name |
    EndTask String Yes Dependency end task name |

    Docker

    Docker container information

    Used by actions: CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    User String Yes Docker Hub username or Tencent Registry username
    Password String Yes Docker Hub password or Tencent Registry password
    Image String Yes For Docker Hub, enter "[user/repo]:[tag]"; for Tencent Registry, enter "ccr.ccs.tencentyun.com/[namespace/repo]:[tag]"
    Server String No For Docker Hub, this can be left blank, but please ensure public network access is present. For Tencent Registry, the server address is "ccr.ccs.tencentyun.com"

    EnhancedService

    Describes the configuration of enhanced services, such as Cloud Security and Cloud Monitor.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    SecurityService RunSecurityServiceEnabled No Enables cloud security service. If this parameter is not specified, the cloud security service will be enabled by default.
    MonitorService RunMonitorServiceEnabled No Enables cloud monitor service. If this parameter is not specified, the cloud monitor service will be enabled by default.

    EnvData

    Compute environment information

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    InstanceType String No CVM instance type, which cannot be present together with InstanceTypes or InstanceTypeOptions at the same time.
    ImageId String No CVM image ID
    SystemDisk SystemDisk No Information of the instance's system disk configuration
    DataDisks Array of DataDisk No Information of the instance's data disk configuration
    VirtualPrivateCloud VirtualPrivateCloud No Information of the VPC configuration, which cannot be specified together with Zones and VirtualPrivateClouds.
    InternetAccessible InternetAccessible No Information of the public network bandwidth configuration
    InstanceName String No CVM instance display name
    LoginSettings LoginSettings No Instance login settings
    SecurityGroupIds Array of String No Security group of the instance
    EnhancedService EnhancedService No Enhanced service. This parameter is used to specify whether to enable Cloud Security, Cloud Monitoring and other services. If this parameter is not specified, Cloud Monitoring and Cloud Security will be enabled by default.
    InstanceChargeType String No CVM instance billing method
  • POSTPAID_BY_HOUR: pay-as-you-go by the hour
  • SPOTPAID: bidding
    Default value: POSTPAID_BY_HOUR.
  • InstanceMarketOptions InstanceMarketOptionsRequest No Market-related options of the instance, such as parameters related to spot instance
    InstanceTypes Array of String No List of CVM instance types, which cannot be present together with InstanceType or InstanceTypeOptions at the same time. After the field is specified, the system will try creating compute nodes in the order of the models until successful creation and then stop the traversal process. Up to 10 models are supported.
    InstanceTypeOptions InstanceTypeOptions No CVM instance model configuration, which cannot be present together with InstanceType or InstanceTypes at the same time.
    Zones Array of String No List of availability zones (creation of CVM instances across availability zones is supported), which cannot be specified together with VirtualPrivateCloud or VirtualPrivateClouds at the same time.
    VirtualPrivateClouds Array of VirtualPrivateCloud No List of VPCs (creation of CVM instances across VPCs is supported), which cannot be specified together with VirtualPrivateCloud or Zones at the same time.

    EnvVar

    Environment variable

    Used by actions: CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    Name String Yes Environment variable name
    Value String Yes Environment variable value

    EventConfig

    Event configuration

    Used by actions: CreateComputeEnv、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、SubmitJob.

    Name Type Required Description
    EventName String Yes Event type. Value range:
  • "JOB_RUNNING": the job is running, applicable to "SubmitJob".
  • "JOB_SUCCEED: the job succeeded, applicable to "SubmitJob".
  • "JOB_FAILED": the job failed, applicable to "SubmitJob".
  • "JOB_FAILED_INTERRUPTED": the job failed and the instance is retained, applicable to "SubmitJob".
  • "TASK_RUNNING": the task is running, applicable to "SubmitJob".
  • "TASK_SUCCEED": the task succeeded, applicable to "SubmitJob".
  • "TASK_FAILED": the task failed, applicable to "SubmitJob".
  • "TASK_FAILED_INTERRUPTED": the task failed and the instance is retained, applicable to "SubmitJob".
  • "TASK_INSTANCE_RUNNING": the task instance is running, applicable to "SubmitJob".
  • "TASK_INSTANCE_SUCCEED": the task instance succeeded, applicable to "SubmitJob".
  • "TASK_INSTANCE_FAILED": the task instance failed, applicable to "SubmitJob".
  • "TASK_INSTANCE_FAILED_INTERRUPTED": the task instance failed and the instance is retained, applicable to "SubmitJob".
  • "COMPUTE_ENV_CREATED": the compute environment has been created, applicable to "CreateComputeEnv".
  • "COMPUTE_ENV_DELETED": the compute environment has been deleted, applicable to "CreateComputeEnv".
  • "COMPUTE_NODE_CREATED": the compute node has been created, applicable to "CreateComputeEnv" and "SubmitJob".
  • "COMPUTE_NODE_CREATION_FAILED": the compute node creation failed, applicable to "CreateComputeEnv" and "SubmitJob".
  • "COMPUTE_NODE_RUNNING": the compute node is running, applicable to "CreateComputeEnv" and "SubmitJob".
  • "COMPUTE_NODE_ABNORMAL": the compute node is exceptional, applicable to "CreateComputeEnv" and "SubmitJob".
  • "COMPUTE_NODE_DELETING": the compute node has been deleted, applicable to "CreateComputeEnv" and "SubmitJob".
  • EventVars Array of EventVar Yes Custom key-value pair

    EventVar

    Custom key-value pair

    Used by actions: CreateComputeEnv、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、SubmitJob.

    Name Type Required Description
    Name String Yes Custom key
    Value String Yes Custom value

    Externals

    Additional data

    Used by actions: DescribeCvmZoneInstanceConfigInfos.

    Name Type Required Description
    ReleaseAddress Boolean No Release address
    Note: This field may return null, indicating that no valid value is found.
    UnsupportNetworks Array of String No Unsupported network types
    Note: This field may return null, indicating that no valid value is found.
    StorageBlockAttr StorageBlock No Attributes of local HDD storage
    Note: This field may return null, indicating that no valid value is found.

    Filter

    Describes key-value pair filters used for conditional queries, such as filtering results by ID, name and state.

    • If there are multiple Filter parameters, the relationship among them will be logical AND.
    • If there are multiple Values for the same Filter, the relationship among the Values for the same Filter will be logical OR.

    Take the DescribeInstances API as an example. You can use the following filters to query the instances whose availability zone (zone) is Guangzhou Zone 1 and billing method (instance-charge-type) is prepaid or pay-as-you-go:

    Filters.0.Name=zone
    &Filters.0.Values.0=ap-guangzhou-1
    &Filters.1.Name=instance-charge-type
    &Filters.1.Values.0=PREPAID
    &Filters.1.Values.1=POSTPAID_BY_HOUR

    Used by actions: DescribeAvailableCvmInstanceTypes、DescribeComputeEnvActivities、DescribeComputeEnvCreateInfos、DescribeComputeEnvs、DescribeCvmZoneInstanceConfigInfos、DescribeJobs、DescribeTask、DescribeTaskTemplates.

    Name Type Required Description
    Name String Yes Filters.
    Values Array of String Yes Filter values.

    InputMapping

    Input mapping

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    SourcePath String Yes Source path
    DestinationPath String Yes Destination path
    MountOptionParameter String No Mounting configuration item parameter

    InstanceCategoryItem

    List of instance categories

    Used by actions: DescribeInstanceCategories.

    Name Type Description
    InstanceCategory String Instance type name
    InstanceFamilySet Array of String List of instance families

    InstanceMarketOptionsRequest

    Options related to bidding requests

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    SpotOptions SpotMarketOptions Yes Options related to bidding
    MarketType String No Market option type. Currently spot is the only supported value.

    InstanceTypeConfig

    Information of InstanceTypeConfig available to BatchCompute

    Used by actions: DescribeAvailableCvmInstanceTypes.

    Name Type Description
    Mem Integer Memory size in GB.
    Cpu Integer Number of CPU cores.
    InstanceType String Instance model.
    Zone String Availability zone.
    InstanceFamily String Instance model family.

    InstanceTypeOptions

    Instance model configuration.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    CPU Integer Yes Number of CPU cores.
    Memory Integer Yes Memory size in GB.
    InstanceCategories Array of String No Instance model category. Value range: "ALL", "GENERAL", "GENERAL_2", "GENERAL_3", "COMPUTE", "COMPUTE_2", and "COMPUTE_3". Default value: "ALL".

    InstanceTypeQuotaItem

    Describes instance model quota.

    Used by actions: DescribeCvmZoneInstanceConfigInfos.

    Name Type Description
    Zone String Availability zone.
    InstanceType String Instance model.
    InstanceChargeType String Instance billing method. Valid values:
  • PREPAID: prepaid, i.e., monthly subscription
  • POSTPAID_BY_HOUR: pay-as-you-go
  • CDHPAID: you are only billed for the CDH instances, not the CVMs running on the CDHs.
  • SPOTPAID: you are billed based on your bid.
  • NetworkCard Integer ENI type. For example, 25 represents an ENI of 25 GB.
    Externals Externals Additional data.
    Note: This field may return null, indicating that no valid value is found.
    Cpu Integer Number of CPU cores of an instance model.
    Memory Integer Instance memory capacity; unit: GB.
    InstanceFamily String Instance model family.
    TypeName String Model name.
    LocalDiskTypeList Array of LocalDiskType List of local disk specifications. If the parameter returns null, it means that local disks cannot be created.
    Status String Whether an instance model is available. Valid values:
  • SELL: available
  • SOLD_OUT: sold out
  • Price ItemPrice Price of an instance model.

    InternetAccessible

    Describes the accessibility of an instance in the public network, including its network billing method, maximum bandwidth, etc.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    InternetChargeType String No Network billing method. Valid values:
  • BANDWIDTH_PREPAID: prepaid; billed by bandwidth
  • TRAFFIC_POSTPAID_BY_HOUR: pay-as-you-go; billed by traffic on an hourly basis
  • BANDWIDTH_POSTPAID_BY_HOUR: pay-as-you-go; billed by bandwidth on an hourly basis
  • BANDWIDTH_PACKAGE: for bandwidth package users
    Default value: same as the instance billing method for non-bandwidth package users.
  • InternetMaxBandwidthOut Integer No The maximum outbound bandwidth of the public network, in Mbps. The default value is 0 Mbps. The upper limit of bandwidth varies for different models. For more information, see Purchase Network Bandwidth.
    PublicIpAssigned Boolean No Whether to assign a public IP. Valid values:
  • TRUE: Assign a public IP
  • FALSE: Do not assign a public IP

    If the public network bandwidth is greater than 0 Mbps, you can choose whether to assign a public IP; by default a public IP will be assigned. If the public network bandwidth is 0 Mbps, you will not be able to assign a public IP.
  • BandwidthPackageId String No Bandwidth package ID.

    ItemPrice

    Describes pricing information.

    Used by actions: DescribeCvmZoneInstanceConfigInfos.

    Name Type Description
    UnitPrice Float Subsequent unit price (in RMB).
    Note: This field may return null, indicating that no valid value is found.
    ChargeUnit String Subsequent billing unit. Valid values:
  • HOUR: bill by hour. Scenarios using this billing unit include: pay as you go for instances on an hourly basis (POSTPAID_BY_HOUR), and pay as you go for bandwidth on an hourly basis (BANDWIDTH_POSTPAID_BY_HOUR).
  • GB: bill by traffic in GB. Scenarios using this billing unit include: pay as you go for traffic on an hourly basis (TRAFFIC_POSTPAID_BY_HOUR).
    Note: This field may return null, indicating that no valid value is found.
  • OriginalPrice Float Original price of a prepaid instance (in RMB).
    Note: This field may return null, indicating that no valid value is found.
    DiscountPrice Float Discount price of a prepaid instance (in RMB).
    Note: This field may return null, indicating that no valid value is found.

    Job

    Instance

    Used by actions: SubmitJob.

    Name Type Required Description
    Tasks Array of Task Yes Job information
    JobName String No Instance name
    JobDescription String No Instance description
    Priority Integer No Instance priority. Tasks (Task) and task instances (TaskInstance) inherit the priority of the instance
    Dependences Array of Dependence No Dependency information
    Notifications Array of Notification No Notification information
    TaskExecutionDependOn String No This is the dependency of the subsequent task on the previous task if there is a dependent relationship between them. Value range: PRE_TASK_SUCCEED, PRE_TASK_AT_LEAST_PARTLY_SUCCEED, PRE_TASK_FINISHED. Default value: PRE_TASK_SUCCEED.
    StateIfCreateCvmFailed String No Indicates which policy will be used in case that CVM instance creation fails. Value range: FAILED, RUNNABLE. FAILED indicates that the CVM instance creation failure will be processed as an execution failure, while RUNNABLE indicates that the failure will be processed as "keep waiting". Default value: FAILED. StateIfCreateCvmFailed is not valid for submitted jobs for which a compute environment is specified.

    JobView

    Instance information

    Used by actions: DescribeJobs.

    Name Type Description
    JobId String Instance ID
    JobName String Instance name
    JobState String Instance state
    Priority Integer Instance priority
    Placement Placement Location information
    Note: This field may return null, indicating that no valid values can be obtained.
    CreateTime String Creation time
    EndTime String End time
    Note: This field may return null, indicating that no valid values can be obtained.
    TaskMetrics TaskMetrics Task statistical metrics

    LocalDiskType

    Describes local disk specifications.

    Used by actions: DescribeCvmZoneInstanceConfigInfos.

    Name Type Description
    Type String Type of a local disk.
    PartitionType String Attributes of a local disk.
    MinSize Integer Minimum size of a local disk.
    MaxSize Integer Maximum size of a local disk.
    Required String

    LoginSettings

    Describes login settings of an instance.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    Password String No Login password of the instance. The password requirements vary among different operating systems:
  • For Linux instances, the password must be 8-16 characters long and contain at least one character from two of the following categories: [a-z, A-Z], [0-9] and [( ) ~ ! @ # $ % ^ & * - + = &#124; { } [ ] : ; ' , . ? / ]. <br><li>For Windows instances, the password must be 12-16 characters long and contain at least one character from three of the following categories: [a-z], [A-Z], [0-9] and [( ) ~ ! @ # $ % ^ & * - + = { } [ ] : ; ' , . ? /].

    If this parameter is not specified, a random password will be generated and sent to you via the Message Center.
    Note: This field may return null, indicating that no valid value is found.
  • KeyIds Array of String No List of key IDs. After an instance is associated with a key, you can access the instance with the private key in the key pair. You can call DescribeKeyPairs to obtain KeyId. Key and password cannot be specified at the same time. Windows instances do not support keys. Currently, you can only specify one key when purchasing an instance.
    Note: This field may return null, indicating that no valid value is found.
    KeepImageLogin String No Whether to keep the original settings of an image. You cannot specify this parameter and Password or KeyIds.N at the same time. You can specify this parameter as TRUE only when you create an instance using a custom image, a shared image, or an imported image. Valid values:
  • TRUE: keep the login settings of the image
  • FALSE: do not keep the login settings of the image

    Default value: FALSE.
    Note: This field may return null, indicating that no valid value is found.
  • MountDataDisk

    Data disk mounting option

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    LocalPath String Yes Mounting point. For Linux, this parameter should be a valid path. For Windows, this parameter should be a system disk letter such as "H:\"
    FileSystemType String No File system type. For Linux, "EXT3" and "EXT4" are supported and the default value is "EXT3". For Windows, only "NTFS" is supported

    NamedComputeEnv

    Compute environment

    Used by actions: CreateComputeEnv.

    Name Type Required Description
    EnvName String Yes Compute environment name
    DesiredComputeNodeCount Integer Yes Number of desired compute nodes
    EnvDescription String No Compute environment description
    EnvType String No Compute environment management type
    EnvData EnvData No Compute environment's specific parameters
    MountDataDisks Array of MountDataDisk No Data disk mounting option
    Authentications Array of Authentication No Authorization information
    InputMappings Array of InputMapping No Input mapping information
    AgentRunningMode AgentRunningMode No Agent running mode; applicable for Windows
    Notifications Notification No Notification information
    ActionIfComputeNodeInactive String No Inactive node processing policy. Default value: RECREATE, which means that instance resources will be re-created periodically for compute nodes where instance creation fails or is abnormally returned.

    Notification

    Notification information

    Used by actions: CreateComputeEnv、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、SubmitJob.

    Name Type Required Description
    TopicName String Yes CMQ topic name which should be valid and associated with a subscription
    EventConfigs Array of EventConfig Yes Event configuration

    OutputMapping

    Output mapping

    Used by actions: CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    SourcePath String Yes Source path
    DestinationPath String Yes Destination path

    OutputMappingConfig

    Output mapping configuration

    Used by actions: CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    Scene String Yes Storage type. Only COS is supported
    WorkerNum Integer Yes Number of parallel workers
    WorkerPartSize Integer Yes Size of a worker part, in MB.

    Placement

    Describes the location of an instance, including its availability zone, project, host (for CDH products only), master host IP, etc.

    Used by actions: CreateComputeEnv、DescribeComputeEnv、DescribeComputeEnvs、DescribeJobs、SubmitJob.

    Name Type Required Description
    Zone String Yes ID of the Availability Zone where the instance resides. To obtain the availability zone IDs, you can call DescribeZones and look for the Zone fields in the response.
    HostIds Array of String No ID list of CDHs from which the instance can be created. If you have purchased CDHs and specify this parameter, the instances you purchase will be randomly deployed on the CDHs.
    HostIps Array of String No Master host IP used to create the CVM

    RedirectInfo

    Redirection information

    Used by actions: CreateTaskTemplate、DescribeJob、DescribeJobSubmitInfo、DescribeTask、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    StdoutRedirectPath String No Standard output redirection path
    StderrRedirectPath String No Standard error redirection path
    StdoutRedirectFileName String No Standard output redirection file name, which supports three placeholders: ${BATCH_JOB_ID}, ${BATCH_TASK_NAME}, and ${BATCH_TASK_INSTANCE_INDEX}
    StderrRedirectFileName String No Standard error redirection file name, which supports three placeholders: ${BATCH_JOB_ID}, ${BATCH_TASK_NAME}, and ${BATCH_TASK_INSTANCE_INDEX}

    RedirectLocalInfo

    Local redirection information

    Used by actions: CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    StdoutLocalPath String No Standard output redirection local path
    StderrLocalPath String No Standard error redirection local path
    StdoutLocalFileName String No Standard output redirection local file name, which supports three placeholders: ${BATCH_JOB_ID}, ${BATCH_TASK_NAME}, and ${BATCH_TASK_INSTANCE_INDEX}
    StderrLocalFileName String No Standard error redirection local file name, which supports three placeholders: ${BATCH_JOB_ID}, ${BATCH_TASK_NAME}, and ${BATCH_TASK_INSTANCE_INDEX}

    RunMonitorServiceEnabled

    Describes information related to the Cloud Monitor service.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    Enabled Boolean No Whether to enable Cloud Monitor. Valid values:
  • TRUE: enable Cloud Monitor
  • FALSE: do not enable Cloud Monitor

    Default value: TRUE.
  • RunSecurityServiceEnabled

    Describes information related to the Cloud Security service.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    Enabled Boolean No Whether to enable Cloud Security. Valid values:
  • TRUE: enable Cloud Security
  • FALSE: do not enable Cloud Security

    Default value: TRUE.
  • SpotMarketOptions

    Options related to bidding.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    MaxPrice String Yes Bidding price
    SpotInstanceType String No Bidding request type. Currently only "one-time" is supported.

    StorageBlock

    Information on local HDD storage.

    Used by actions: DescribeCvmZoneInstanceConfigInfos.

    Name Type Description
    Type String Local HDD storage type. Value: LOCAL_PRO.
    Note: This field may return null, indicating that no valid value is found.
    MinSize Integer Minimum capacity of local HDD storage
    Note: This field may return null, indicating that no valid value is found.
    MaxSize Integer Maximum capacity of local HDD storage
    Note: This field may return null, indicating that no valid value is found.

    SystemDisk

    Describes information on the block device where the operating system is stored, i.e., the system disk.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    DiskType String No The system disk type. Valid values:
  • LOCAL_BASIC: local disk
  • LOCAL_SSD: local SSD disk
  • CLOUD_BASIC: HDD cloud disk
  • CLOUD_SSD: SSD cloud disk
  • CLOUD_PREMIUM: premium cloud storage

    Default value: CLOUD_BASIC.
  • DiskId String No System disk ID. System disks whose type is LOCAL_BASIC or LOCAL_SSD do not have an ID and do not support this parameter currently.
    DiskSize Integer No System disk size; unit: GB; default value: 50 GB.

    Task

    Task

    Used by actions: CreateTaskTemplate、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    Application Application Yes Application information
    TaskName String No Job name, which should be unique within instance
    TaskInstanceNum Integer No Number of running task instances
    ComputeEnv AnonymousComputeEnv No Compute environment information. One (and only one) parameter must be specified for ComputeEnv and EnvId.
    EnvId String No Compute environment ID. One (and only one) parameter must be specified for ComputeEnv and EnvId.
    RedirectInfo RedirectInfo No Redirection information
    RedirectLocalInfo RedirectLocalInfo No Local redirection information
    InputMappings Array of InputMapping No Input mapping
    OutputMappings Array of OutputMapping No Output mapping
    OutputMappingConfigs Array of OutputMappingConfig No Output mapping configuration
    EnvVars Array of EnvVar No Custom environment variable
    Authentications Array of Authentication No Authorization information
    FailedAction String No The processing method after the TaskInstance fails; Value range: TERMINATE (default), INTERRUPT, FAST_INTERRUPT.
    MaxRetryCount Integer No The maximum number of retries after the task fails. Default value: 0
    Timeout Integer No Timeout period in seconds after the task starts. Defaults value: 86,400
    MaxConcurrentNum Integer No The maximum number of concurrent tasks. There is no limit by default.
    RestartComputeNode Boolean No Restarts the compute node after the task is completed. This is suitable for specifying the compute environment for task execution.
    ResourceMaxRetryCount Integer No Maximum number of retry attempts after failing to create computing resources such as the CVM in the task launch process. Default value: 0.

    TaskInstanceLog

    Task instance log details.

    Used by actions: DescribeTaskLogs.

    Name Type Description
    TaskInstanceIndex Integer Task instance
    StdoutLog String Standard output log (Base64-encoded)
    Note: This field may return null, indicating that no valid values can be obtained.
    StderrLog String Standard error log (Base64-encoded)
    Note: This field may return null, indicating that no valid values can be obtained.
    StdoutRedirectPath String Standard output redirection path
    Note: This field may return null, indicating that no valid values can be obtained.
    StderrRedirectPath String Standard error redirection path
    Note: This field may return null, indicating that no valid values can be obtained.
    StdoutRedirectFileName String Standard output redirection file name
    Note: This field may return null, indicating that no valid values can be obtained.
    StderrRedirectFileName String Standard error redirection file name
    Note: This field may return null, indicating that no valid values can be obtained.

    TaskInstanceMetrics

    Task instance statistical metrics

    Used by actions: DescribeTask.

    Name Type Description
    SubmittedCount Integer Submitted count
    PendingCount Integer Pending count
    RunnableCount Integer Runnable count
    StartingCount Integer Starting count
    RunningCount Integer Running count
    SucceedCount Integer Succeed count
    FailedInterruptedCount Integer FailedInterrupted count
    FailedCount Integer Failed count

    TaskInstanceView

    Task instance view information

    Used by actions: DescribeJob、DescribeTask.

    Name Type Description
    TaskInstanceIndex Integer Task instance index
    TaskInstanceState String Task instance state
    ExitCode Integer Exit code after application execution is completed
    Note: This field may return null, indicating that no valid values can be obtained.
    StateReason String Task instance state reason. If the task instance fails, the reason for the failure will be logged.
    ComputeNodeInstanceId String The InstanceId of the compute node (e.g., CVM instance) where the task instance is running. This field is empty if the task instance is not running or has already been completed and will change when the task instance is retried
    Note: This field may return null, indicating that no valid values can be obtained.
    CreateTime String Creation time
    LaunchTime String Start time
    Note: This field may return null, indicating that no valid values can be obtained.
    RunningTime String Running start time
    Note: This field may return null, indicating that no valid values can be obtained.
    EndTime String End time
    Note: This field may return null, indicating that no valid values can be obtained.
    RedirectInfo RedirectInfo Redirection information
    StateDetailedReason String Task instance state reason details. If the task instance fails, the reason for the failure will be logged

    TaskMetrics

    Task statistical metrics

    Used by actions: DescribeJob、DescribeJobs.

    Name Type Description
    SubmittedCount Integer Submitted count
    PendingCount Integer Pending count
    RunnableCount Integer Runnable count
    StartingCount Integer Starting count
    RunningCount Integer Running count
    SucceedCount Integer Succeed count
    FailedInterruptedCount Integer FailedInterrupted count
    FailedCount Integer Failed count

    TaskTemplateView

    Task template information

    Used by actions: DescribeTaskTemplates.

    Name Type Description
    TaskTemplateId String Task template ID
    TaskTemplateName String Task template name
    TaskTemplateDescription String Task template description
    TaskTemplateInfo Task Task template information
    CreateTime String Creation time

    TaskView

    Task view information

    Used by actions: DescribeJob.

    Name Type Description
    TaskName String Task name
    TaskState String Task state
    CreateTime String Create time
    EndTime String End time
    Note: This field may return null, indicating that no valid values can be obtained.

    VirtualPrivateCloud

    Describes information on VPC, including subnets, IP addresses, etc.

    Used by actions: CreateComputeEnv、CreateTaskTemplate、DescribeComputeEnvCreateInfo、DescribeComputeEnvCreateInfos、DescribeJobSubmitInfo、DescribeTaskTemplates、ModifyTaskTemplate、SubmitJob.

    Name Type Required Description
    VpcId String Yes
    SubnetId String Yes VPC subnet ID in the format subnet-xxx. To obtain valid subnet IDs, you can log in to the console or call DescribeSubnets and look for the unSubnetId fields in the response. If you specify DEFAULT for both SubnetId and VpcId when creating an instance, the default VPC will be used.
    AsVpcGateway Boolean No Whether to use an instance as a public gateway. An instance can be used as a public gateway only when it has a public IP and resides in a VPC. Valid values:
  • TRUE: use the instance as a public gateway
  • FALSE: do not use the instance as a public gateway

    Default value: FALSE.
  • PrivateIpAddresses Array of String No Array of VPC subnet IPs. You can use this parameter when creating instances or modifying VPC attributes of instances. Currently you can specify multiple IPs in one subnet only when creating multiple instances at the same time.
    Ipv6AddressCount Integer No