Data Types

Last updated: 2020-11-09 15:40:29

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
Tags Array of Tag Tag list of the compute environment.
Note: This field may return null, indicating that no valid value was found.

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
ResourceType String Compute environment resource type. Valid values: CVM, CPM (Bare Metal)
NextAction String Next action
AttachedComputeNodeCount Integer Number of compute nodes added to the compute environment by the user
Tags Array of Tag Tag list bound to the compute environment.
Note: This field may return null, indicating that no valid value was found.

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
ResourceType String Compute environment resource type. Valid values: CVM, CPM (Bare Metal)
ResourceOrigin String Source of compute environment resources.
BATCH_CREATED: instance resources created by BatchCompute.

USER_ATTACHED: instance resources added by users to the compute environment.

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 Data disk size (in GB). The minimum adjustment increment is 10 GB. The value range varies by data disk type. For more information on limits, see Storage Overview. The default value is 0, indicating that no data disk is purchased. For more information, see the product documentation.
DiskType String No Data disk type. For more information about limits on different data disk types, see Storage Overview. 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_HSSD: Enhanced SSD

    Default value: LOCAL_BASIC.

    This parameter is invalid for the ResizeInstanceDisk API.
  • DiskId String No Data disk ID. Data disks of the type LOCAL_BASIC or LOCAL_SSD do not have IDs and do not support this parameter.
    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.
    Encrypt Boolean No Specifies whether the data disk is encrypted. Valid values:
  • TRUE: encrypted
  • FALSE: not encrypted

    Default value: FALSE

    This parameter is only used with RunInstances.
    Note: this field may return null, indicating that no valid value is obtained.
  • KmsKeyId String No ID of the custom CMK in the format of UUID or “kms-abcd1234”. This parameter is used to encrypt cloud disks.

    Currently, this parameter is only used in the RunInstances API.
    Note: this field may return null, indicating that no valid values can be obtained.

    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 Not supported network. Value:
  • BASIC: classic network
  • VPC1.0: VPC1.0
    Note: This field may return null, indicating that no valid value was found.
  • StorageBlockAttr StorageBlock No Attributes of local HDD storage
    Note: This field may return null, indicating that no valid value is found.

    Filter

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

    • If there are multiple Filter parameters, they are evaluated using the logical AND operator.
    • If a Filter contains multiple Values, they are evaluated using the logical OR operator.

    Take DescribeInstances as an example. You can use the following filters to query the instances in availability zone (zone) Guangzhou Zone 1 and whose billing plan (instance-charge-type) is 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=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

    Instance

    Describes information on an instance

    Used by actions: AttachInstances.

    Name Type Required Description
    InstanceId String Yes Instance ID.
    ImageId String No Image ID.
    LoginSettings LoginSettings No Instance login settings.

    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 plan. Valid values:
  • POSTPAID_BY_HOUR: pay after use. You are billed for your traffic by the hour.
  • CDHPAID: CDH billing plan. Applicable to CDH only, not the instances on the host.
  • 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.
    SoldOutReason String Details of out-of-stock items
    Note: this field may return null, indicating that no valid value is obtained.
    InstanceBandwidth Float Private network bandwidth, in Gbps.
    InstancePps Integer The max packet sending and receiving capability (in 10k PPS).
    StorageBlockAmount Integer Number of local storage blocks.
    CpuType String CPU type.
    Gpu Integer Number of GPUs of the instance.
    Fpga Integer Number of FPGAs of the instance.
    Remark String Descriptive information of the instance.

    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 connection billing plan. Valid value:
  • TRAFFIC_POSTPAID_BY_HOUR: pay after use. You are billed for your traffic, by the hour.
  • 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. To obatin the IDs, you can call DescribeBandwidthPackages and look for the BandwidthPackageId fields in the response.

    ItemPrice

    Describes pricing information.

    Used by actions: DescribeCvmZoneInstanceConfigInfos.

    Name Type Description
    UnitPrice Float The original unit price for pay-as-you-go mode in USD.
  • When a billing tier is returned, it indicates the price fo the returned billing tier. For example, if UnitPriceSecondStep is returned, it refers to the unit price for the usage between 0 to 96 hours. Otherwise, it refers to that the unit price for unlimited usage.
    Note: this field may return null, indicating that no valid value is obtained.
  • ChargeUnit String Billing unit for pay-as-you-go mode. Valid values:
  • HOUR: billed on an hourly basis. It's used for hourly postpaid instances (POSTPAID_BY_HOUR).
  • GB: bill by traffic in GB. It's used for postpaid products that are billed by the hourly traffic (TRAFFIC_POSTPAID_BY_HOUR).
    Note: this field may return null, indicating that no valid value is obtained.
  • OriginalPrice Float The original price of a pay-in-advance instance, in USD.
    Note: this field may return null, indicating that no valid value is obtained.
    DiscountPrice Float Discount price of a prepaid instance, in USD.
    Note: this field may return null, indicating that no valid value is obtained.
    Discount Float Percentage of the original price. For example, if you enter "20.0", the discounted price will be 20% of the original price.
    Note: this field may return null, indicating that no valid values can be obtained.
    UnitPriceDiscount Float The discounted unit price for pay-as-you-go mode in USD.
  • When a billing tier is returned, it indicates the price fo the returned billing tier. For example, if UnitPriceSecondStep is returned, it refers to the unit price for the usage between 0 to 96 hours. Otherwise, it refers to that the unit price for unlimited usage.
    Note: this field may return null, indicating that no valid value is obtained.
  • UnitPriceSecondStep Float Original unit price for the usage between 96 to 360 hours in USD. It's applicable to pay-as-you-go mode.
    Note: this field may return null, indicating that no valid value is obtained.
    UnitPriceDiscountSecondStep Float Discounted unit price for the usage between 96 to 360 hours in USD. It's applicable to pay-as-you-go mode.
    Note: this field may return null, indicating that no valid value is obtained.
    UnitPriceThirdStep Float Original unit price for the usage after 360 hours in USD. It's applicable to pay-as-you-go mode.
    Note: this field may return null, indicating that no valid value is obtained.
    UnitPriceDiscountThirdStep Float Discounted unit price for the usage after 360 hours in USD. It's applicable to pay-as-you-go mode.
    Note: this field may return null, indicating that no valid value is obtained.

    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.
    Tags Array of Tag No Tag list. By setting this parameter, you can bind tags to a job. Each job supports up to 10 tags.

    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
    Tags Array of Tag Tag list bound to the job.
    Note: This field may return null, indicating that no valid value was found.

    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 Whether a local disk is required during purchase. Valid values:
  • REQUIRED: required
  • OPTIONAL: optional
  • LoginSettings

    Describes the configuration and information related to instance login.

    Used by actions: AttachInstances, 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.
  • 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.
    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.
  • 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.
    ResourceMaxRetryCount Integer No When the instances are failed to be created or returned because of exceptions, the related compute node will retry to create instances periodically. This parameter specifies the maximum retry attempts. The max value is 11 and the default value is 7.
    Tags Array of Tag No Tag list. By setting this parameter, you can bind tags to a compute environment. Each compute environment supports up to 10 tags.

    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), primary host IP, etc.

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

    Name Type Required Description
    Zone String Yes The ID of availability zone where the instance locates. It can obtained in the Zone field returned by DescribeZones API.
    ProjectId Integer No ID of the project to which the instance belongs. To obtain the project IDs, you can call DescribeProject and look for the projectId fields in the response. If this parameter is not specified, the default project will be used.
    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
    HostId String No The ID of the CDH to which the instance belongs, only used as an output parameter.

    RedirectInfo

    Redirection information

    Used by actions: CreateTaskTemplate, 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 System disk type. For more information on limits of system disk types, see Storage Overview. Valid values:
  • LOCAL_BASIC: local disk
  • LOCAL_SSD: local SSD disk
  • CLOUD_BASIC: HDD cloud disk
  • CLOUD_SSD: SSD
  • CLOUD_PREMIUM: Premium Cloud Storage

    The disk type currently in stock will be used by default.
  • 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.

    Tag

    Information on tags

    Used by actions: CreateComputeEnv, CreateTaskTemplate, DescribeComputeEnv, DescribeComputeEnvCreateInfo, DescribeComputeEnvCreateInfos, DescribeComputeEnvs, DescribeJob, DescribeJobSubmitInfo, DescribeJobs, DescribeTaskTemplates, SubmitJob.

    Name Type Required Description
    Key String Yes Tag key.
    Note: This field may return null, indicating that no valid value was found.
    Value String Yes Tag value.
    Note: This field may return null, indicating that no valid value was found.

    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: DescribeJob, 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: 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
    Tags Array of Tag Tag list bound to the task template.
    Note: This field may return null, indicating that no valid value was found.

    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 VPC ID in the format of vpc-xxx. To obtain valid VPC IDs, you can log in to the console or call the DescribeVpcEx API and look for the unVpcId fields in the response. If you specify DEFAULT for both VpcId and SubnetId when creating an instance, the default VPC will be used.
    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 Number of IPv6 addresses randomly generated for the ENI.

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help