@byteplus/pulumi-bytepluscc 0.0.46 → 0.0.48

package/ecs/scheduledInstance.d.ts

@@ -0,0 +1,741 @@
+import * as pulumi from "@pulumi/pulumi";
+import * as inputs from "../types/input";
+import * as outputs from "../types/output";
+/**
+ * Volcano Engine Cloud Server (ECS) ScheduledInstance. A ScheduledInstance allows you to schedule the automatic delivery of a batch of ECS instances at a future time. Supports two types: Elastic Scheduled Instance (Esi) and Elastic Scheduled Instance - Segmented (Segmented).
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as bytepluscc from "@byteplus/pulumi-bytepluscc";
+ *
+ * const example = new bytepluscc.ecs.ScheduledInstance("example", {
+ *     imageId: "image-xxxxxxxxxxxxxxxxxxxx",
+ *     instanceName: "ecs-example",
+ *     instanceTypeId: "ecs.c3a.large",
+ *     scheduledInstanceName: "scheduled-example",
+ *     zoneId: "ap-southeast-1a",
+ *     networkInterfaces: [{
+ *         security_group_ids: ["sg-xxxxxxxxxxxxxxxxxxxx"],
+ *         subnet_id: "subnet-xxxxxxxxxxxxxxxxxxxx",
+ *         vpc_id: "vpc-xxxxxxxxxxxxxxxxxxxx",
+ *         primary_ip_address: "",
+ *         private_ip_addresses: [],
+ *     }],
+ *     volumes: [{
+ *         size: 20,
+ *         volume_type: "ESSD_PL0",
+ *         delete_with_instance: false,
+ *         extra_performance_iops: 0,
+ *         extra_performance_throughput_mb: 0,
+ *         extra_performance_type_id: "",
+ *         snapshot_id: "",
+ *     }],
+ *     instanceCount: 1,
+ *     minCount: 1,
+ *     elasticScheduledInstanceType: "Esi",
+ *     startDeliveryAt: "2026-12-31T02:00:00+08:00",
+ *     endDeliveryAt: "2026-12-31T02:10:00+08:00",
+ *     hostName: "cc-test",
+ *     uniqueSuffix: false,
+ *     suffixIndex: 1,
+ *     projectName: "default",
+ *     description: "instance-desc",
+ *     scheduledInstanceDescription: "desc",
+ *     keyPairName: "example-keypair",
+ *     keepImageCredential: false,
+ *     installRunCommandAgent: false,
+ *     deletionProtection: false,
+ *     securityEnhancementStrategy: "Active",
+ *     httpTokens: "optional",
+ *     userData: "",
+ *     eipAddress: {
+ *         bandwidth_mbps: 1,
+ *         bandwidth_package_id: "",
+ *         charge_type: "PayByTraffic",
+ *         isp: "BGP",
+ *         release_with_instance: false,
+ *         security_protection_instance_id: 0,
+ *         security_protection_types: [],
+ *     },
+ *     tags: [
+ *         {
+ *             key: "key1",
+ *             value: "1",
+ *         },
+ *         {
+ *             key: "key2",
+ *             value: "2",
+ *         },
+ *     ],
+ * });
+ * ```
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import bytepluscc:ecs/scheduledInstance:ScheduledInstance example "scheduled_instance_id"
+ * ```
+ */
+export declare class ScheduledInstance extends pulumi.CustomResource {
+    /**
+     * Get an existing ScheduledInstance resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ScheduledInstanceState, opts?: pulumi.CustomResourceOptions): ScheduledInstance;
+    /**
+     * Returns true if the given object is an instance of ScheduledInstance.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is ScheduledInstance;
+    /**
+     * Instance automatic release time. Must be at a 10-minute mark. When `ElasticScheduledInstanceType` is set to Segmented, this parameter is required. Value range:   - When `DeliveryType` is Reserve, the earliest release time is one hour after the reserved delivery time slot.   - When `DeliveryType` is Immediate, the earliest release time is the next 10-minute mark after the current time. For example, if the current time is 5:02, the earliest automatic release time is 5:20.
+     */
+    readonly autoReleaseAt: pulumi.Output<string>;
+    /**
+     * Specify the maximum CPU frequency in GHz. Value range: between the base frequency and turbo frequency of the CPU.
+     *
+     *   **Note:**
+     *     - Currently, only g3al (4xlarge, 8xlarge, 16xlarge, 32xlarge), c3al (4xlarge, 8xlarge, 16xlarge, 32xlarge), r3al (4xlarge, 8xlarge, 16xlarge), g4i, c4i, r4i, g4ie, c4ie, r4ie instances support this parameter.
+     *   For details on base/turbo frequency and more information, see [Instance Specifications].
+     *     - This feature is in invitation-only testing. To use it, contact your account manager.
+     */
+    readonly cpuMaxFrequency: pulumi.Output<number>;
+    /**
+     * ScheduledInstance creation time.
+     */
+    readonly createdAt: pulumi.Output<string>;
+    /**
+     * Instance deletion protection attribute. Specifies whether the instance can be deleted via console or API. Values:
+     *     - true: Enable instance deletion protection
+     *     - false (default): Disable instance deletion protection
+     */
+    readonly deletionProtection: pulumi.Output<boolean>;
+    /**
+     * Number of delivered instances
+     */
+    readonly deliveryCount: pulumi.Output<number>;
+    /**
+     * Elastic Scheduled Instance   - Segmented delivery type. Values:   - Reserve (default): scheduled delivery   - Immediate: immediate delivery
+     *   **Note:**   - This parameter is required only when `ElasticScheduledInstanceType` is set to `Segmented`.   - Elastic Scheduled Instance   - Segmented is currently in invitation testing. To apply for a trial, please contact your account manager.
+     */
+    readonly deliveryType: pulumi.Output<string>;
+    /**
+     * Instance description. The default value is an empty string.   - Must start with a letter or Chinese character.   - Can only contain Chinese characters, letters, numbers, period '.', space, underscore '_', hyphen '-', equals sign '=', English comma ',', Chinese comma '，', and Chinese period '。'   - Maximum length is 255 characters.
+     */
+    readonly description: pulumi.Output<string>;
+    /**
+     * Public IP configuration specified when creating the instance.
+     */
+    readonly eipAddress: pulumi.Output<outputs.ecs.ScheduledInstanceEipAddress>;
+    /**
+     * Elastic scheduled instance type. Options:   - Esi (default): Elastic scheduled instance.   - Segmented: Elastic scheduled instance (time segment).
+     *   **Note:** Elastic scheduled instance (time segment) is currently in invite-only beta. To try it, please contact your account manager.
+     */
+    readonly elasticScheduledInstanceType: pulumi.Output<string>;
+    /**
+     * Instance end delivery time. Must be on a 10-minute mark, and the interval with `StartDeliveryAt` must be 10 minutes
+     *     - If `ElasticScheduledInstanceType` is `Esi`, the end delivery time must be within 4–8 hours after reservation
+     *     - If `ElasticScheduledInstanceType` is `Segmented`:
+     *       - If `DeliveryType` is `Reserve`, the end delivery time must be within 24 hours after reservation
+     *       - If `DeliveryType` is `Immediate`, this parameter is not required
+     */
+    readonly endDeliveryAt: pulumi.Output<string>;
+    /**
+     * Instance hostname, which is the computer name inside the instance operating system.
+     *     - Linux instances:
+     *       - Letters, numbers, periods ("."), and hyphens ("-") are allowed.
+     *       - Cannot start or end with a hyphen or period, and hyphens and periods cannot be used consecutively.
+     *       - Length must be between 2 and 63 characters for Linux systems.
+     *     - Windows instances:
+     *       - Letters, numbers, and hyphens ("-") are allowed, but the name cannot consist of only numbers.
+     *       - Cannot start or end with a hyphen, and hyphens cannot be used consecutively.
+     *       - Length must be between 2 and 15 characters for Windows systems.
+     *
+     *   **Note:**
+     *     - If left blank, the hostname is automatically generated according to the iv  - + initial hostname rule, for example, iv-3tigy72q3u3vj0******.
+     *     - Initial hostname generation logic:
+     *       - Linux: Extract all characters after the instance ID i-.
+     *       - Windows: Extract the last 12 characters after the instance ID i-.
+     *     - When creating instances in batches, you can use the `name_prefix[begin_number,bits]name_suffix` format to customize sequential hostnames. For details, see [Batch Set Sequential Instance Names or Hostnames].
+     */
+    readonly hostName: pulumi.Output<string>;
+    /**
+     * When creating a high-performance computing GPU instance, specify the high-performance computing cluster ID.
+     */
+    readonly hpcClusterId: pulumi.Output<string>;
+    /**
+     * Instance metadata access mode: whether to enforce enhanced mode. Values:   - optional (default): Not enforced (compatible mode), meaning instance metadata can be accessed either directly or via token-based authentication.   - required: Enforced (enhanced mode only), meaning instance metadata can only be accessed via token-based authentication.
+     *   **Note:**   - For details on how to view metadata and supported metadata items, see [View Instance Metadata].   - Enhanced mode is currently in invitation testing. To request access, contact your account manager.
+     */
+    readonly httpTokens: pulumi.Output<string>;
+    /**
+     * The image ID used to launch the instance. You can use [DescribeImages] to query available image resources.
+     */
+    readonly imageId: pulumi.Output<string>;
+    /**
+     * Whether to install the Cloud Assistant Agent when creating the instance. Values:
+     *     - true: Install during creation
+     *     - false (default): Do not install during creation
+     *
+     *   **Note:**
+     *   For more information about Cloud Assistant, see [Cloud Assistant Overview].
+     */
+    readonly installRunCommandAgent: pulumi.Output<boolean>;
+    /**
+     * Instance configuration information for the elastic reservation order.
+     */
+    readonly instanceConfig: pulumi.Output<outputs.ecs.ScheduledInstanceInstanceConfig>;
+    /**
+     * Number of instances to create. Value range:
+     *     - If `ElasticScheduledInstanceType` is set to `Esi`, value range is 1–500.
+     *     - If `ElasticScheduledInstanceType` is set to `Segmented`, then:
+     *       - If `DeliveryType` is `Reserve`, value range is 1–500.
+     *       - If `DeliveryType` is `Immediate`, value range is 1–100.
+     *
+     *   **Note:**
+     *   If 0 is entered, the default is 1.
+     */
+    readonly instanceCount: pulumi.Output<number>;
+    /**
+     * Instance name
+     *     - Must start with a letter or Chinese character
+     *     - Can only contain Chinese characters, letters, numbers, underscores "_", hyphens "-", and periods "."
+     *     - Length must be between 1 and 128 characters
+     *
+     *   **Note:**
+     *     - If the instance has a `SuffixIndex` sequential suffix, the instance name length includes the suffix
+     *     - When creating instances in bulk, you can use the `name_prefix[begin_number,bits]name_suffix` format to customize sequential instance names. For details, see [Batch Set Sequential Instance Names or Host Names]
+     */
+    readonly instanceName: pulumi.Output<string>;
+    /**
+     * Instance type.   - For supported instance types available for reservation, see [Elastic Scheduled Instance Overview].   - You can call [DescribeAvailableResource] to query inventory information for compute resources in the availability zone.
+     */
+    readonly instanceTypeId: pulumi.Output<string>;
+    /**
+     * Elastic reservation order expiration time.
+     */
+    readonly invalidAt: pulumi.Output<string>;
+    /**
+     * Whether to retain image settings. Values:   - true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login.   - false (default): Do not retain image settings.
+     *   **Note:**  - Only custom images and shared images support this feature.   - When this parameter is set to `true`, do not specify `PassWord` or `KeyPairName`.
+     */
+    readonly keepImageCredential: pulumi.Output<boolean>;
+    /**
+     * To log in to the instance using an SSH key, specify the name of an existing key pair. You can call [DescribeKeyPairs] to view existing key pairs; if none are available, call [CreateKeyPair] to create one
+     *
+     *   **Note:**
+     *     - Windows instances do not support SSH key login. Even if this parameter is provided, only the password `Password` is valid
+     *     - Linux instances support login via password or key pair. If both `KeyPairName` and `Password` are set when calling this API, only `KeyPairName` takes effect
+     */
+    readonly keyPairName: pulumi.Output<string>;
+    /**
+     * Specify the minimum number of Elastic Scheduled Instances to create. Value range:   - ESI-General, ESI-Segmented (Scheduled Delivery): 1–500   - ESI-Segmented (Immediate Delivery): 1–100
+     *   **Note:**   - The minimum instance creation quantity `MinCount` ≤ creation quantity `Count`.   - If inventory quantity > creation quantity `Count`, create according to `Count`.   - If minimum creation quantity `MinCount` ≤ inventory quantity ≤ creation quantity `Count`, create according to inventory quantity.   - If inventory quantity < minimum creation quantity `MinCount`, creation fails due to insufficient inventory.
+     */
+    readonly minCount: pulumi.Output<number>;
+    /**
+     * Network interface configuration information specified when creating the instance.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    readonly networkInterfaces: pulumi.Output<outputs.ecs.ScheduledInstanceNetworkInterface[]>;
+    /**
+     * If you want to log in to the instance using the 'password' method, specify the initial login password for the administrator account through this parameter. The Linux administrator account is root, and the Windows administrator account is Administrator. Password complexity requirements:   - Length must be between 8 and 30 characters.   - Password must contain at least three of the following: uppercase letters, lowercase letters, numbers, and special characters.   - Allowed special characters: `~!@#$%^&*()_-+=|{}[]:;'<>,.?/  - Cannot start with '/' or '$6$'.
+     *   **Note:** Login credentials support three methods: 'password', 'key pair', and 'retain image settings'. When using the 'password' method to log in, it is recommended to increase password complexity for enhanced security.
+     */
+    readonly password: pulumi.Output<string>;
+    /**
+     * Project to which the resource belongs. Each resource can belong to only one project.   - Can only contain letters, numbers, underscore '_', period '.', and hyphen '-'.   - Maximum length is 64 characters.
+     */
+    readonly projectName: pulumi.Output<string>;
+    /**
+     * Number of released instances.
+     */
+    readonly releaseCount: pulumi.Output<number>;
+    /**
+     * Description of the flexible reservation order. The default value is an empty string.   - Must start with a letter or Chinese character.   - Can only contain Chinese characters, letters, numbers, period '.', space, underscore '_', hyphen '-', equals sign '=', English comma ',', Chinese comma '，', and Chinese period '。'   - Maximum length is 255 characters.
+     */
+    readonly scheduledInstanceDescription: pulumi.Output<string>;
+    /**
+     * Elastic reservation order ID.
+     */
+    readonly scheduledInstanceId: pulumi.Output<string>;
+    /**
+     * Name of the elastic reservation order. Values:   - Cannot start with a number, hyphen, or underscore.   - Can only contain Chinese characters, letters, numbers, underscores, and hyphens.   - Length limit: 1–128 characters.   - Special characters are not supported.
+     */
+    readonly scheduledInstanceName: pulumi.Output<string>;
+    /**
+     * Whether to enable security hardening. Values:   - Active: Enable security hardening, applies only to public images.   - InActive: Disable security hardening, applies to all image types.
+     */
+    readonly securityEnhancementStrategy: pulumi.Output<string>;
+    /**
+     * Instance delivery start time. Must be on a 10-minute mark (e.g., 10:00, 10:10, 10:20, etc.).   - When `ElasticScheduledInstanceType` is set to `Esi`, delivery time is within 4–8 hours after reservation.   - When `ElasticScheduledInstanceType` is set to `Segmented`:     - If `DeliveryType` is `Reserve`, delivery time is within 24 hours after reservation.     - If `DeliveryType` is `Immediate`, this parameter is not required.
+     */
+    readonly startDeliveryAt: pulumi.Output<string>;
+    /**
+     * ScheduledInstance status.
+     */
+    readonly status: pulumi.Output<string>;
+    /**
+     * Starting sequence number for ordered suffix. Value range: 1–999. Default is 1.
+     */
+    readonly suffixIndex: pulumi.Output<number>;
+    /**
+     * Flexible reservation order tag information.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    readonly tags: pulumi.Output<outputs.ecs.ScheduledInstanceTag[]>;
+    /**
+     * Indicates whether to automatically add an ordered suffix to `HostName` and `InstanceName` when creating multiple instances. Values:   - true: Enable ordered suffix.   - false (default): Disable ordered suffix.
+     *   **Note:**  - When ordered suffix is enabled and `HostName` is empty, the system will automatically generate a host name without an ordered suffix.   - When ordered suffix is enabled and the `[begin_number,bits]` naming format is specified for `HostName` or `InstanceName`, see [Batch Set Ordered Instance Names or Host Names] for the final effect.
+     */
+    readonly uniqueSuffix: pulumi.Output<boolean>;
+    /**
+     * Elastic reservation order update time.
+     */
+    readonly updatedAt: pulumi.Output<string>;
+    /**
+     * Instance custom data. Custom data must be Base64-encoded, and the size before encoding must not exceed 16KB. If not specified, defaults to empty.
+     */
+    readonly userData: pulumi.Output<string>;
+    /**
+     * Cloud disk configuration information specified when creating an instance.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    readonly volumes: pulumi.Output<outputs.ecs.ScheduledInstanceVolume[]>;
+    /**
+     * Availability zone ID where the instance is located. You can call [DescribeZones] to query the availability zones in a region.
+     */
+    readonly zoneId: pulumi.Output<string>;
+    /**
+     * Create a ScheduledInstance resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: ScheduledInstanceArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering ScheduledInstance resources.
+ */
+export interface ScheduledInstanceState {
+    /**
+     * Instance automatic release time. Must be at a 10-minute mark. When `ElasticScheduledInstanceType` is set to Segmented, this parameter is required. Value range:   - When `DeliveryType` is Reserve, the earliest release time is one hour after the reserved delivery time slot.   - When `DeliveryType` is Immediate, the earliest release time is the next 10-minute mark after the current time. For example, if the current time is 5:02, the earliest automatic release time is 5:20.
+     */
+    autoReleaseAt?: pulumi.Input<string | undefined>;
+    /**
+     * Specify the maximum CPU frequency in GHz. Value range: between the base frequency and turbo frequency of the CPU.
+     *
+     *   **Note:**
+     *     - Currently, only g3al (4xlarge, 8xlarge, 16xlarge, 32xlarge), c3al (4xlarge, 8xlarge, 16xlarge, 32xlarge), r3al (4xlarge, 8xlarge, 16xlarge), g4i, c4i, r4i, g4ie, c4ie, r4ie instances support this parameter.
+     *   For details on base/turbo frequency and more information, see [Instance Specifications].
+     *     - This feature is in invitation-only testing. To use it, contact your account manager.
+     */
+    cpuMaxFrequency?: pulumi.Input<number | undefined>;
+    /**
+     * ScheduledInstance creation time.
+     */
+    createdAt?: pulumi.Input<string | undefined>;
+    /**
+     * Instance deletion protection attribute. Specifies whether the instance can be deleted via console or API. Values:
+     *     - true: Enable instance deletion protection
+     *     - false (default): Disable instance deletion protection
+     */
+    deletionProtection?: pulumi.Input<boolean | undefined>;
+    /**
+     * Number of delivered instances
+     */
+    deliveryCount?: pulumi.Input<number | undefined>;
+    /**
+     * Elastic Scheduled Instance   - Segmented delivery type. Values:   - Reserve (default): scheduled delivery   - Immediate: immediate delivery
+     *   **Note:**   - This parameter is required only when `ElasticScheduledInstanceType` is set to `Segmented`.   - Elastic Scheduled Instance   - Segmented is currently in invitation testing. To apply for a trial, please contact your account manager.
+     */
+    deliveryType?: pulumi.Input<string | undefined>;
+    /**
+     * Instance description. The default value is an empty string.   - Must start with a letter or Chinese character.   - Can only contain Chinese characters, letters, numbers, period '.', space, underscore '_', hyphen '-', equals sign '=', English comma ',', Chinese comma '，', and Chinese period '。'   - Maximum length is 255 characters.
+     */
+    description?: pulumi.Input<string | undefined>;
+    /**
+     * Public IP configuration specified when creating the instance.
+     */
+    eipAddress?: pulumi.Input<inputs.ecs.ScheduledInstanceEipAddress | undefined>;
+    /**
+     * Elastic scheduled instance type. Options:   - Esi (default): Elastic scheduled instance.   - Segmented: Elastic scheduled instance (time segment).
+     *   **Note:** Elastic scheduled instance (time segment) is currently in invite-only beta. To try it, please contact your account manager.
+     */
+    elasticScheduledInstanceType?: pulumi.Input<string | undefined>;
+    /**
+     * Instance end delivery time. Must be on a 10-minute mark, and the interval with `StartDeliveryAt` must be 10 minutes
+     *     - If `ElasticScheduledInstanceType` is `Esi`, the end delivery time must be within 4–8 hours after reservation
+     *     - If `ElasticScheduledInstanceType` is `Segmented`:
+     *       - If `DeliveryType` is `Reserve`, the end delivery time must be within 24 hours after reservation
+     *       - If `DeliveryType` is `Immediate`, this parameter is not required
+     */
+    endDeliveryAt?: pulumi.Input<string | undefined>;
+    /**
+     * Instance hostname, which is the computer name inside the instance operating system.
+     *     - Linux instances:
+     *       - Letters, numbers, periods ("."), and hyphens ("-") are allowed.
+     *       - Cannot start or end with a hyphen or period, and hyphens and periods cannot be used consecutively.
+     *       - Length must be between 2 and 63 characters for Linux systems.
+     *     - Windows instances:
+     *       - Letters, numbers, and hyphens ("-") are allowed, but the name cannot consist of only numbers.
+     *       - Cannot start or end with a hyphen, and hyphens cannot be used consecutively.
+     *       - Length must be between 2 and 15 characters for Windows systems.
+     *
+     *   **Note:**
+     *     - If left blank, the hostname is automatically generated according to the iv  - + initial hostname rule, for example, iv-3tigy72q3u3vj0******.
+     *     - Initial hostname generation logic:
+     *       - Linux: Extract all characters after the instance ID i-.
+     *       - Windows: Extract the last 12 characters after the instance ID i-.
+     *     - When creating instances in batches, you can use the `name_prefix[begin_number,bits]name_suffix` format to customize sequential hostnames. For details, see [Batch Set Sequential Instance Names or Hostnames].
+     */
+    hostName?: pulumi.Input<string | undefined>;
+    /**
+     * When creating a high-performance computing GPU instance, specify the high-performance computing cluster ID.
+     */
+    hpcClusterId?: pulumi.Input<string | undefined>;
+    /**
+     * Instance metadata access mode: whether to enforce enhanced mode. Values:   - optional (default): Not enforced (compatible mode), meaning instance metadata can be accessed either directly or via token-based authentication.   - required: Enforced (enhanced mode only), meaning instance metadata can only be accessed via token-based authentication.
+     *   **Note:**   - For details on how to view metadata and supported metadata items, see [View Instance Metadata].   - Enhanced mode is currently in invitation testing. To request access, contact your account manager.
+     */
+    httpTokens?: pulumi.Input<string | undefined>;
+    /**
+     * The image ID used to launch the instance. You can use [DescribeImages] to query available image resources.
+     */
+    imageId?: pulumi.Input<string | undefined>;
+    /**
+     * Whether to install the Cloud Assistant Agent when creating the instance. Values:
+     *     - true: Install during creation
+     *     - false (default): Do not install during creation
+     *
+     *   **Note:**
+     *   For more information about Cloud Assistant, see [Cloud Assistant Overview].
+     */
+    installRunCommandAgent?: pulumi.Input<boolean | undefined>;
+    /**
+     * Instance configuration information for the elastic reservation order.
+     */
+    instanceConfig?: pulumi.Input<inputs.ecs.ScheduledInstanceInstanceConfig | undefined>;
+    /**
+     * Number of instances to create. Value range:
+     *     - If `ElasticScheduledInstanceType` is set to `Esi`, value range is 1–500.
+     *     - If `ElasticScheduledInstanceType` is set to `Segmented`, then:
+     *       - If `DeliveryType` is `Reserve`, value range is 1–500.
+     *       - If `DeliveryType` is `Immediate`, value range is 1–100.
+     *
+     *   **Note:**
+     *   If 0 is entered, the default is 1.
+     */
+    instanceCount?: pulumi.Input<number | undefined>;
+    /**
+     * Instance name
+     *     - Must start with a letter or Chinese character
+     *     - Can only contain Chinese characters, letters, numbers, underscores "_", hyphens "-", and periods "."
+     *     - Length must be between 1 and 128 characters
+     *
+     *   **Note:**
+     *     - If the instance has a `SuffixIndex` sequential suffix, the instance name length includes the suffix
+     *     - When creating instances in bulk, you can use the `name_prefix[begin_number,bits]name_suffix` format to customize sequential instance names. For details, see [Batch Set Sequential Instance Names or Host Names]
+     */
+    instanceName?: pulumi.Input<string | undefined>;
+    /**
+     * Instance type.   - For supported instance types available for reservation, see [Elastic Scheduled Instance Overview].   - You can call [DescribeAvailableResource] to query inventory information for compute resources in the availability zone.
+     */
+    instanceTypeId?: pulumi.Input<string | undefined>;
+    /**
+     * Elastic reservation order expiration time.
+     */
+    invalidAt?: pulumi.Input<string | undefined>;
+    /**
+     * Whether to retain image settings. Values:   - true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login.   - false (default): Do not retain image settings.
+     *   **Note:**  - Only custom images and shared images support this feature.   - When this parameter is set to `true`, do not specify `PassWord` or `KeyPairName`.
+     */
+    keepImageCredential?: pulumi.Input<boolean | undefined>;
+    /**
+     * To log in to the instance using an SSH key, specify the name of an existing key pair. You can call [DescribeKeyPairs] to view existing key pairs; if none are available, call [CreateKeyPair] to create one
+     *
+     *   **Note:**
+     *     - Windows instances do not support SSH key login. Even if this parameter is provided, only the password `Password` is valid
+     *     - Linux instances support login via password or key pair. If both `KeyPairName` and `Password` are set when calling this API, only `KeyPairName` takes effect
+     */
+    keyPairName?: pulumi.Input<string | undefined>;
+    /**
+     * Specify the minimum number of Elastic Scheduled Instances to create. Value range:   - ESI-General, ESI-Segmented (Scheduled Delivery): 1–500   - ESI-Segmented (Immediate Delivery): 1–100
+     *   **Note:**   - The minimum instance creation quantity `MinCount` ≤ creation quantity `Count`.   - If inventory quantity > creation quantity `Count`, create according to `Count`.   - If minimum creation quantity `MinCount` ≤ inventory quantity ≤ creation quantity `Count`, create according to inventory quantity.   - If inventory quantity < minimum creation quantity `MinCount`, creation fails due to insufficient inventory.
+     */
+    minCount?: pulumi.Input<number | undefined>;
+    /**
+     * Network interface configuration information specified when creating the instance.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    networkInterfaces?: pulumi.Input<pulumi.Input<inputs.ecs.ScheduledInstanceNetworkInterface>[] | undefined>;
+    /**
+     * If you want to log in to the instance using the 'password' method, specify the initial login password for the administrator account through this parameter. The Linux administrator account is root, and the Windows administrator account is Administrator. Password complexity requirements:   - Length must be between 8 and 30 characters.   - Password must contain at least three of the following: uppercase letters, lowercase letters, numbers, and special characters.   - Allowed special characters: `~!@#$%^&*()_-+=|{}[]:;'<>,.?/  - Cannot start with '/' or '$6$'.
+     *   **Note:** Login credentials support three methods: 'password', 'key pair', and 'retain image settings'. When using the 'password' method to log in, it is recommended to increase password complexity for enhanced security.
+     */
+    password?: pulumi.Input<string | undefined>;
+    /**
+     * Project to which the resource belongs. Each resource can belong to only one project.   - Can only contain letters, numbers, underscore '_', period '.', and hyphen '-'.   - Maximum length is 64 characters.
+     */
+    projectName?: pulumi.Input<string | undefined>;
+    /**
+     * Number of released instances.
+     */
+    releaseCount?: pulumi.Input<number | undefined>;
+    /**
+     * Description of the flexible reservation order. The default value is an empty string.   - Must start with a letter or Chinese character.   - Can only contain Chinese characters, letters, numbers, period '.', space, underscore '_', hyphen '-', equals sign '=', English comma ',', Chinese comma '，', and Chinese period '。'   - Maximum length is 255 characters.
+     */
+    scheduledInstanceDescription?: pulumi.Input<string | undefined>;
+    /**
+     * Elastic reservation order ID.
+     */
+    scheduledInstanceId?: pulumi.Input<string | undefined>;
+    /**
+     * Name of the elastic reservation order. Values:   - Cannot start with a number, hyphen, or underscore.   - Can only contain Chinese characters, letters, numbers, underscores, and hyphens.   - Length limit: 1–128 characters.   - Special characters are not supported.
+     */
+    scheduledInstanceName?: pulumi.Input<string | undefined>;
+    /**
+     * Whether to enable security hardening. Values:   - Active: Enable security hardening, applies only to public images.   - InActive: Disable security hardening, applies to all image types.
+     */
+    securityEnhancementStrategy?: pulumi.Input<string | undefined>;
+    /**
+     * Instance delivery start time. Must be on a 10-minute mark (e.g., 10:00, 10:10, 10:20, etc.).   - When `ElasticScheduledInstanceType` is set to `Esi`, delivery time is within 4–8 hours after reservation.   - When `ElasticScheduledInstanceType` is set to `Segmented`:     - If `DeliveryType` is `Reserve`, delivery time is within 24 hours after reservation.     - If `DeliveryType` is `Immediate`, this parameter is not required.
+     */
+    startDeliveryAt?: pulumi.Input<string | undefined>;
+    /**
+     * ScheduledInstance status.
+     */
+    status?: pulumi.Input<string | undefined>;
+    /**
+     * Starting sequence number for ordered suffix. Value range: 1–999. Default is 1.
+     */
+    suffixIndex?: pulumi.Input<number | undefined>;
+    /**
+     * Flexible reservation order tag information.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    tags?: pulumi.Input<pulumi.Input<inputs.ecs.ScheduledInstanceTag>[] | undefined>;
+    /**
+     * Indicates whether to automatically add an ordered suffix to `HostName` and `InstanceName` when creating multiple instances. Values:   - true: Enable ordered suffix.   - false (default): Disable ordered suffix.
+     *   **Note:**  - When ordered suffix is enabled and `HostName` is empty, the system will automatically generate a host name without an ordered suffix.   - When ordered suffix is enabled and the `[begin_number,bits]` naming format is specified for `HostName` or `InstanceName`, see [Batch Set Ordered Instance Names or Host Names] for the final effect.
+     */
+    uniqueSuffix?: pulumi.Input<boolean | undefined>;
+    /**
+     * Elastic reservation order update time.
+     */
+    updatedAt?: pulumi.Input<string | undefined>;
+    /**
+     * Instance custom data. Custom data must be Base64-encoded, and the size before encoding must not exceed 16KB. If not specified, defaults to empty.
+     */
+    userData?: pulumi.Input<string | undefined>;
+    /**
+     * Cloud disk configuration information specified when creating an instance.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    volumes?: pulumi.Input<pulumi.Input<inputs.ecs.ScheduledInstanceVolume>[] | undefined>;
+    /**
+     * Availability zone ID where the instance is located. You can call [DescribeZones] to query the availability zones in a region.
+     */
+    zoneId?: pulumi.Input<string | undefined>;
+}
+/**
+ * The set of arguments for constructing a ScheduledInstance resource.
+ */
+export interface ScheduledInstanceArgs {
+    /**
+     * Instance automatic release time. Must be at a 10-minute mark. When `ElasticScheduledInstanceType` is set to Segmented, this parameter is required. Value range:   - When `DeliveryType` is Reserve, the earliest release time is one hour after the reserved delivery time slot.   - When `DeliveryType` is Immediate, the earliest release time is the next 10-minute mark after the current time. For example, if the current time is 5:02, the earliest automatic release time is 5:20.
+     */
+    autoReleaseAt?: pulumi.Input<string | undefined>;
+    /**
+     * Specify the maximum CPU frequency in GHz. Value range: between the base frequency and turbo frequency of the CPU.
+     *
+     *   **Note:**
+     *     - Currently, only g3al (4xlarge, 8xlarge, 16xlarge, 32xlarge), c3al (4xlarge, 8xlarge, 16xlarge, 32xlarge), r3al (4xlarge, 8xlarge, 16xlarge), g4i, c4i, r4i, g4ie, c4ie, r4ie instances support this parameter.
+     *   For details on base/turbo frequency and more information, see [Instance Specifications].
+     *     - This feature is in invitation-only testing. To use it, contact your account manager.
+     */
+    cpuMaxFrequency?: pulumi.Input<number | undefined>;
+    /**
+     * Instance deletion protection attribute. Specifies whether the instance can be deleted via console or API. Values:
+     *     - true: Enable instance deletion protection
+     *     - false (default): Disable instance deletion protection
+     */
+    deletionProtection?: pulumi.Input<boolean | undefined>;
+    /**
+     * Elastic Scheduled Instance   - Segmented delivery type. Values:   - Reserve (default): scheduled delivery   - Immediate: immediate delivery
+     *   **Note:**   - This parameter is required only when `ElasticScheduledInstanceType` is set to `Segmented`.   - Elastic Scheduled Instance   - Segmented is currently in invitation testing. To apply for a trial, please contact your account manager.
+     */
+    deliveryType?: pulumi.Input<string | undefined>;
+    /**
+     * Instance description. The default value is an empty string.   - Must start with a letter or Chinese character.   - Can only contain Chinese characters, letters, numbers, period '.', space, underscore '_', hyphen '-', equals sign '=', English comma ',', Chinese comma '，', and Chinese period '。'   - Maximum length is 255 characters.
+     */
+    description?: pulumi.Input<string | undefined>;
+    /**
+     * Public IP configuration specified when creating the instance.
+     */
+    eipAddress?: pulumi.Input<inputs.ecs.ScheduledInstanceEipAddress | undefined>;
+    /**
+     * Elastic scheduled instance type. Options:   - Esi (default): Elastic scheduled instance.   - Segmented: Elastic scheduled instance (time segment).
+     *   **Note:** Elastic scheduled instance (time segment) is currently in invite-only beta. To try it, please contact your account manager.
+     */
+    elasticScheduledInstanceType?: pulumi.Input<string | undefined>;
+    /**
+     * Instance end delivery time. Must be on a 10-minute mark, and the interval with `StartDeliveryAt` must be 10 minutes
+     *     - If `ElasticScheduledInstanceType` is `Esi`, the end delivery time must be within 4–8 hours after reservation
+     *     - If `ElasticScheduledInstanceType` is `Segmented`:
+     *       - If `DeliveryType` is `Reserve`, the end delivery time must be within 24 hours after reservation
+     *       - If `DeliveryType` is `Immediate`, this parameter is not required
+     */
+    endDeliveryAt?: pulumi.Input<string | undefined>;
+    /**
+     * Instance hostname, which is the computer name inside the instance operating system.
+     *     - Linux instances:
+     *       - Letters, numbers, periods ("."), and hyphens ("-") are allowed.
+     *       - Cannot start or end with a hyphen or period, and hyphens and periods cannot be used consecutively.
+     *       - Length must be between 2 and 63 characters for Linux systems.
+     *     - Windows instances:
+     *       - Letters, numbers, and hyphens ("-") are allowed, but the name cannot consist of only numbers.
+     *       - Cannot start or end with a hyphen, and hyphens cannot be used consecutively.
+     *       - Length must be between 2 and 15 characters for Windows systems.
+     *
+     *   **Note:**
+     *     - If left blank, the hostname is automatically generated according to the iv  - + initial hostname rule, for example, iv-3tigy72q3u3vj0******.
+     *     - Initial hostname generation logic:
+     *       - Linux: Extract all characters after the instance ID i-.
+     *       - Windows: Extract the last 12 characters after the instance ID i-.
+     *     - When creating instances in batches, you can use the `name_prefix[begin_number,bits]name_suffix` format to customize sequential hostnames. For details, see [Batch Set Sequential Instance Names or Hostnames].
+     */
+    hostName?: pulumi.Input<string | undefined>;
+    /**
+     * When creating a high-performance computing GPU instance, specify the high-performance computing cluster ID.
+     */
+    hpcClusterId?: pulumi.Input<string | undefined>;
+    /**
+     * Instance metadata access mode: whether to enforce enhanced mode. Values:   - optional (default): Not enforced (compatible mode), meaning instance metadata can be accessed either directly or via token-based authentication.   - required: Enforced (enhanced mode only), meaning instance metadata can only be accessed via token-based authentication.
+     *   **Note:**   - For details on how to view metadata and supported metadata items, see [View Instance Metadata].   - Enhanced mode is currently in invitation testing. To request access, contact your account manager.
+     */
+    httpTokens?: pulumi.Input<string | undefined>;
+    /**
+     * The image ID used to launch the instance. You can use [DescribeImages] to query available image resources.
+     */
+    imageId: pulumi.Input<string>;
+    /**
+     * Whether to install the Cloud Assistant Agent when creating the instance. Values:
+     *     - true: Install during creation
+     *     - false (default): Do not install during creation
+     *
+     *   **Note:**
+     *   For more information about Cloud Assistant, see [Cloud Assistant Overview].
+     */
+    installRunCommandAgent?: pulumi.Input<boolean | undefined>;
+    /**
+     * Number of instances to create. Value range:
+     *     - If `ElasticScheduledInstanceType` is set to `Esi`, value range is 1–500.
+     *     - If `ElasticScheduledInstanceType` is set to `Segmented`, then:
+     *       - If `DeliveryType` is `Reserve`, value range is 1–500.
+     *       - If `DeliveryType` is `Immediate`, value range is 1–100.
+     *
+     *   **Note:**
+     *   If 0 is entered, the default is 1.
+     */
+    instanceCount?: pulumi.Input<number | undefined>;
+    /**
+     * Instance name
+     *     - Must start with a letter or Chinese character
+     *     - Can only contain Chinese characters, letters, numbers, underscores "_", hyphens "-", and periods "."
+     *     - Length must be between 1 and 128 characters
+     *
+     *   **Note:**
+     *     - If the instance has a `SuffixIndex` sequential suffix, the instance name length includes the suffix
+     *     - When creating instances in bulk, you can use the `name_prefix[begin_number,bits]name_suffix` format to customize sequential instance names. For details, see [Batch Set Sequential Instance Names or Host Names]
+     */
+    instanceName: pulumi.Input<string>;
+    /**
+     * Instance type.   - For supported instance types available for reservation, see [Elastic Scheduled Instance Overview].   - You can call [DescribeAvailableResource] to query inventory information for compute resources in the availability zone.
+     */
+    instanceTypeId: pulumi.Input<string>;
+    /**
+     * Whether to retain image settings. Values:   - true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login.   - false (default): Do not retain image settings.
+     *   **Note:**  - Only custom images and shared images support this feature.   - When this parameter is set to `true`, do not specify `PassWord` or `KeyPairName`.
+     */
+    keepImageCredential?: pulumi.Input<boolean | undefined>;
+    /**
+     * To log in to the instance using an SSH key, specify the name of an existing key pair. You can call [DescribeKeyPairs] to view existing key pairs; if none are available, call [CreateKeyPair] to create one
+     *
+     *   **Note:**
+     *     - Windows instances do not support SSH key login. Even if this parameter is provided, only the password `Password` is valid
+     *     - Linux instances support login via password or key pair. If both `KeyPairName` and `Password` are set when calling this API, only `KeyPairName` takes effect
+     */
+    keyPairName?: pulumi.Input<string | undefined>;
+    /**
+     * Specify the minimum number of Elastic Scheduled Instances to create. Value range:   - ESI-General, ESI-Segmented (Scheduled Delivery): 1–500   - ESI-Segmented (Immediate Delivery): 1–100
+     *   **Note:**   - The minimum instance creation quantity `MinCount` ≤ creation quantity `Count`.   - If inventory quantity > creation quantity `Count`, create according to `Count`.   - If minimum creation quantity `MinCount` ≤ inventory quantity ≤ creation quantity `Count`, create according to inventory quantity.   - If inventory quantity < minimum creation quantity `MinCount`, creation fails due to insufficient inventory.
+     */
+    minCount?: pulumi.Input<number | undefined>;
+    /**
+     * Network interface configuration information specified when creating the instance.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    networkInterfaces: pulumi.Input<pulumi.Input<inputs.ecs.ScheduledInstanceNetworkInterface>[]>;
+    /**
+     * If you want to log in to the instance using the 'password' method, specify the initial login password for the administrator account through this parameter. The Linux administrator account is root, and the Windows administrator account is Administrator. Password complexity requirements:   - Length must be between 8 and 30 characters.   - Password must contain at least three of the following: uppercase letters, lowercase letters, numbers, and special characters.   - Allowed special characters: `~!@#$%^&*()_-+=|{}[]:;'<>,.?/  - Cannot start with '/' or '$6$'.
+     *   **Note:** Login credentials support three methods: 'password', 'key pair', and 'retain image settings'. When using the 'password' method to log in, it is recommended to increase password complexity for enhanced security.
+     */
+    password?: pulumi.Input<string | undefined>;
+    /**
+     * Project to which the resource belongs. Each resource can belong to only one project.   - Can only contain letters, numbers, underscore '_', period '.', and hyphen '-'.   - Maximum length is 64 characters.
+     */
+    projectName?: pulumi.Input<string | undefined>;
+    /**
+     * Description of the flexible reservation order. The default value is an empty string.   - Must start with a letter or Chinese character.   - Can only contain Chinese characters, letters, numbers, period '.', space, underscore '_', hyphen '-', equals sign '=', English comma ',', Chinese comma '，', and Chinese period '。'   - Maximum length is 255 characters.
+     */
+    scheduledInstanceDescription?: pulumi.Input<string | undefined>;
+    /**
+     * Name of the elastic reservation order. Values:   - Cannot start with a number, hyphen, or underscore.   - Can only contain Chinese characters, letters, numbers, underscores, and hyphens.   - Length limit: 1–128 characters.   - Special characters are not supported.
+     */
+    scheduledInstanceName: pulumi.Input<string>;
+    /**
+     * Whether to enable security hardening. Values:   - Active: Enable security hardening, applies only to public images.   - InActive: Disable security hardening, applies to all image types.
+     */
+    securityEnhancementStrategy?: pulumi.Input<string | undefined>;
+    /**
+     * Instance delivery start time. Must be on a 10-minute mark (e.g., 10:00, 10:10, 10:20, etc.).   - When `ElasticScheduledInstanceType` is set to `Esi`, delivery time is within 4–8 hours after reservation.   - When `ElasticScheduledInstanceType` is set to `Segmented`:     - If `DeliveryType` is `Reserve`, delivery time is within 24 hours after reservation.     - If `DeliveryType` is `Immediate`, this parameter is not required.
+     */
+    startDeliveryAt?: pulumi.Input<string | undefined>;
+    /**
+     * Starting sequence number for ordered suffix. Value range: 1–999. Default is 1.
+     */
+    suffixIndex?: pulumi.Input<number | undefined>;
+    /**
+     * Flexible reservation order tag information.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    tags?: pulumi.Input<pulumi.Input<inputs.ecs.ScheduledInstanceTag>[] | undefined>;
+    /**
+     * Indicates whether to automatically add an ordered suffix to `HostName` and `InstanceName` when creating multiple instances. Values:   - true: Enable ordered suffix.   - false (default): Disable ordered suffix.
+     *   **Note:**  - When ordered suffix is enabled and `HostName` is empty, the system will automatically generate a host name without an ordered suffix.   - When ordered suffix is enabled and the `[begin_number,bits]` naming format is specified for `HostName` or `InstanceName`, see [Batch Set Ordered Instance Names or Host Names] for the final effect.
+     */
+    uniqueSuffix?: pulumi.Input<boolean | undefined>;
+    /**
+     * Instance custom data. Custom data must be Base64-encoded, and the size before encoding must not exceed 16KB. If not specified, defaults to empty.
+     */
+    userData?: pulumi.Input<string | undefined>;
+    /**
+     * Cloud disk configuration information specified when creating an instance.
+     *  Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
+     */
+    volumes: pulumi.Input<pulumi.Input<inputs.ecs.ScheduledInstanceVolume>[]>;
+    /**
+     * Availability zone ID where the instance is located. You can call [DescribeZones] to query the availability zones in a region.
+     */
+    zoneId: pulumi.Input<string>;
+}
+//# sourceMappingURL=scheduledInstance.d.ts.map