alicloud.ecs.EcsInvocation
Explore with Pulumi AI
Provides a ECS Invocation resource.
For information about ECS Invocation and how to use it, see What is Invocation.
NOTE: Available since v1.168.0+.
Example Usage
Basic Usage
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const config = new pulumi.Config();
const name = config.get("name") || "tf-example";
const default = alicloud.getZones({
availableDiskCategory: "cloud_efficiency",
availableResourceCreation: "VSwitch",
});
const defaultGetInstanceTypes = _default.then(_default => alicloud.ecs.getInstanceTypes({
availabilityZone: _default.zones?.[0]?.id,
}));
const defaultGetImages = alicloud.ecs.getImages({
nameRegex: "^ubuntu",
mostRecent: true,
owners: "system",
});
const defaultNetwork = new alicloud.vpc.Network("default", {
vpcName: name,
cidrBlock: "172.16.0.0/16",
});
const defaultSwitch = new alicloud.vpc.Switch("default", {
vpcId: defaultNetwork.id,
cidrBlock: "172.16.0.0/24",
zoneId: _default.then(_default => _default.zones?.[0]?.id),
vswitchName: name,
});
const defaultSecurityGroup = new alicloud.ecs.SecurityGroup("default", {
name: name,
vpcId: defaultNetwork.id,
});
const defaultSecurityGroupRule = new alicloud.ecs.SecurityGroupRule("default", {
type: "ingress",
ipProtocol: "tcp",
nicType: "intranet",
policy: "accept",
portRange: "22/22",
priority: 1,
securityGroupId: defaultSecurityGroup.id,
cidrIp: "172.16.0.0/24",
});
const defaultInstance = new alicloud.ecs.Instance("default", {
vswitchId: defaultSwitch.id,
imageId: defaultGetImages.then(defaultGetImages => defaultGetImages.images?.[0]?.id),
instanceType: defaultGetInstanceTypes.then(defaultGetInstanceTypes => defaultGetInstanceTypes.instanceTypes?.[0]?.id),
systemDiskCategory: "cloud_efficiency",
internetChargeType: "PayByTraffic",
internetMaxBandwidthOut: 5,
securityGroups: [defaultSecurityGroup.id],
instanceName: name,
});
const defaultCommand = new alicloud.ecs.Command("default", {
name: name,
commandContent: "ZWNobyBoZWxsbyx7e25hbWV9fQ==",
description: "For Terraform Test",
type: "RunShellScript",
workingDir: "/root",
enableParameter: true,
});
const defaultEcsInvocation = new alicloud.ecs.EcsInvocation("default", {
commandId: defaultCommand.id,
instanceIds: [defaultInstance.id],
});
import pulumi
import pulumi_alicloud as alicloud
config = pulumi.Config()
name = config.get("name")
if name is None:
name = "tf-example"
default = alicloud.get_zones(available_disk_category="cloud_efficiency",
available_resource_creation="VSwitch")
default_get_instance_types = alicloud.ecs.get_instance_types(availability_zone=default.zones[0].id)
default_get_images = alicloud.ecs.get_images(name_regex="^ubuntu",
most_recent=True,
owners="system")
default_network = alicloud.vpc.Network("default",
vpc_name=name,
cidr_block="172.16.0.0/16")
default_switch = alicloud.vpc.Switch("default",
vpc_id=default_network.id,
cidr_block="172.16.0.0/24",
zone_id=default.zones[0].id,
vswitch_name=name)
default_security_group = alicloud.ecs.SecurityGroup("default",
name=name,
vpc_id=default_network.id)
default_security_group_rule = alicloud.ecs.SecurityGroupRule("default",
type="ingress",
ip_protocol="tcp",
nic_type="intranet",
policy="accept",
port_range="22/22",
priority=1,
security_group_id=default_security_group.id,
cidr_ip="172.16.0.0/24")
default_instance = alicloud.ecs.Instance("default",
vswitch_id=default_switch.id,
image_id=default_get_images.images[0].id,
instance_type=default_get_instance_types.instance_types[0].id,
system_disk_category="cloud_efficiency",
internet_charge_type="PayByTraffic",
internet_max_bandwidth_out=5,
security_groups=[default_security_group.id],
instance_name=name)
default_command = alicloud.ecs.Command("default",
name=name,
command_content="ZWNobyBoZWxsbyx7e25hbWV9fQ==",
description="For Terraform Test",
type="RunShellScript",
working_dir="/root",
enable_parameter=True)
default_ecs_invocation = alicloud.ecs.EcsInvocation("default",
command_id=default_command.id,
instance_ids=[default_instance.id])
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ecs"
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
cfg := config.New(ctx, "")
name := "tf-example"
if param := cfg.Get("name"); param != "" {
name = param
}
_default, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
AvailableDiskCategory: pulumi.StringRef("cloud_efficiency"),
AvailableResourceCreation: pulumi.StringRef("VSwitch"),
}, nil)
if err != nil {
return err
}
defaultGetInstanceTypes, err := ecs.GetInstanceTypes(ctx, &ecs.GetInstanceTypesArgs{
AvailabilityZone: pulumi.StringRef(_default.Zones[0].Id),
}, nil)
if err != nil {
return err
}
defaultGetImages, err := ecs.GetImages(ctx, &ecs.GetImagesArgs{
NameRegex: pulumi.StringRef("^ubuntu"),
MostRecent: pulumi.BoolRef(true),
Owners: pulumi.StringRef("system"),
}, nil)
if err != nil {
return err
}
defaultNetwork, err := vpc.NewNetwork(ctx, "default", &vpc.NetworkArgs{
VpcName: pulumi.String(name),
CidrBlock: pulumi.String("172.16.0.0/16"),
})
if err != nil {
return err
}
defaultSwitch, err := vpc.NewSwitch(ctx, "default", &vpc.SwitchArgs{
VpcId: defaultNetwork.ID(),
CidrBlock: pulumi.String("172.16.0.0/24"),
ZoneId: pulumi.String(_default.Zones[0].Id),
VswitchName: pulumi.String(name),
})
if err != nil {
return err
}
defaultSecurityGroup, err := ecs.NewSecurityGroup(ctx, "default", &ecs.SecurityGroupArgs{
Name: pulumi.String(name),
VpcId: defaultNetwork.ID(),
})
if err != nil {
return err
}
_, err = ecs.NewSecurityGroupRule(ctx, "default", &ecs.SecurityGroupRuleArgs{
Type: pulumi.String("ingress"),
IpProtocol: pulumi.String("tcp"),
NicType: pulumi.String("intranet"),
Policy: pulumi.String("accept"),
PortRange: pulumi.String("22/22"),
Priority: pulumi.Int(1),
SecurityGroupId: defaultSecurityGroup.ID(),
CidrIp: pulumi.String("172.16.0.0/24"),
})
if err != nil {
return err
}
defaultInstance, err := ecs.NewInstance(ctx, "default", &ecs.InstanceArgs{
VswitchId: defaultSwitch.ID(),
ImageId: pulumi.String(defaultGetImages.Images[0].Id),
InstanceType: pulumi.String(defaultGetInstanceTypes.InstanceTypes[0].Id),
SystemDiskCategory: pulumi.String("cloud_efficiency"),
InternetChargeType: pulumi.String("PayByTraffic"),
InternetMaxBandwidthOut: pulumi.Int(5),
SecurityGroups: pulumi.StringArray{
defaultSecurityGroup.ID(),
},
InstanceName: pulumi.String(name),
})
if err != nil {
return err
}
defaultCommand, err := ecs.NewCommand(ctx, "default", &ecs.CommandArgs{
Name: pulumi.String(name),
CommandContent: pulumi.String("ZWNobyBoZWxsbyx7e25hbWV9fQ=="),
Description: pulumi.String("For Terraform Test"),
Type: pulumi.String("RunShellScript"),
WorkingDir: pulumi.String("/root"),
EnableParameter: pulumi.Bool(true),
})
if err != nil {
return err
}
_, err = ecs.NewEcsInvocation(ctx, "default", &ecs.EcsInvocationArgs{
CommandId: defaultCommand.ID(),
InstanceIds: pulumi.StringArray{
defaultInstance.ID(),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var config = new Config();
var name = config.Get("name") ?? "tf-example";
var @default = AliCloud.GetZones.Invoke(new()
{
AvailableDiskCategory = "cloud_efficiency",
AvailableResourceCreation = "VSwitch",
});
var defaultGetInstanceTypes = AliCloud.Ecs.GetInstanceTypes.Invoke(new()
{
AvailabilityZone = @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
});
var defaultGetImages = AliCloud.Ecs.GetImages.Invoke(new()
{
NameRegex = "^ubuntu",
MostRecent = true,
Owners = "system",
});
var defaultNetwork = new AliCloud.Vpc.Network("default", new()
{
VpcName = name,
CidrBlock = "172.16.0.0/16",
});
var defaultSwitch = new AliCloud.Vpc.Switch("default", new()
{
VpcId = defaultNetwork.Id,
CidrBlock = "172.16.0.0/24",
ZoneId = @default.Apply(@default => @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id)),
VswitchName = name,
});
var defaultSecurityGroup = new AliCloud.Ecs.SecurityGroup("default", new()
{
Name = name,
VpcId = defaultNetwork.Id,
});
var defaultSecurityGroupRule = new AliCloud.Ecs.SecurityGroupRule("default", new()
{
Type = "ingress",
IpProtocol = "tcp",
NicType = "intranet",
Policy = "accept",
PortRange = "22/22",
Priority = 1,
SecurityGroupId = defaultSecurityGroup.Id,
CidrIp = "172.16.0.0/24",
});
var defaultInstance = new AliCloud.Ecs.Instance("default", new()
{
VswitchId = defaultSwitch.Id,
ImageId = defaultGetImages.Apply(getImagesResult => getImagesResult.Images[0]?.Id),
InstanceType = defaultGetInstanceTypes.Apply(getInstanceTypesResult => getInstanceTypesResult.InstanceTypes[0]?.Id),
SystemDiskCategory = "cloud_efficiency",
InternetChargeType = "PayByTraffic",
InternetMaxBandwidthOut = 5,
SecurityGroups = new[]
{
defaultSecurityGroup.Id,
},
InstanceName = name,
});
var defaultCommand = new AliCloud.Ecs.Command("default", new()
{
Name = name,
CommandContent = "ZWNobyBoZWxsbyx7e25hbWV9fQ==",
Description = "For Terraform Test",
Type = "RunShellScript",
WorkingDir = "/root",
EnableParameter = true,
});
var defaultEcsInvocation = new AliCloud.Ecs.EcsInvocation("default", new()
{
CommandId = defaultCommand.Id,
InstanceIds = new[]
{
defaultInstance.Id,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.AlicloudFunctions;
import com.pulumi.alicloud.inputs.GetZonesArgs;
import com.pulumi.alicloud.ecs.EcsFunctions;
import com.pulumi.alicloud.ecs.inputs.GetInstanceTypesArgs;
import com.pulumi.alicloud.ecs.inputs.GetImagesArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.ecs.SecurityGroup;
import com.pulumi.alicloud.ecs.SecurityGroupArgs;
import com.pulumi.alicloud.ecs.SecurityGroupRule;
import com.pulumi.alicloud.ecs.SecurityGroupRuleArgs;
import com.pulumi.alicloud.ecs.Instance;
import com.pulumi.alicloud.ecs.InstanceArgs;
import com.pulumi.alicloud.ecs.Command;
import com.pulumi.alicloud.ecs.CommandArgs;
import com.pulumi.alicloud.ecs.EcsInvocation;
import com.pulumi.alicloud.ecs.EcsInvocationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var config = ctx.config();
final var name = config.get("name").orElse("tf-example");
final var default = AlicloudFunctions.getZones(GetZonesArgs.builder()
.availableDiskCategory("cloud_efficiency")
.availableResourceCreation("VSwitch")
.build());
final var defaultGetInstanceTypes = EcsFunctions.getInstanceTypes(GetInstanceTypesArgs.builder()
.availabilityZone(default_.zones()[0].id())
.build());
final var defaultGetImages = EcsFunctions.getImages(GetImagesArgs.builder()
.nameRegex("^ubuntu")
.mostRecent(true)
.owners("system")
.build());
var defaultNetwork = new Network("defaultNetwork", NetworkArgs.builder()
.vpcName(name)
.cidrBlock("172.16.0.0/16")
.build());
var defaultSwitch = new Switch("defaultSwitch", SwitchArgs.builder()
.vpcId(defaultNetwork.id())
.cidrBlock("172.16.0.0/24")
.zoneId(default_.zones()[0].id())
.vswitchName(name)
.build());
var defaultSecurityGroup = new SecurityGroup("defaultSecurityGroup", SecurityGroupArgs.builder()
.name(name)
.vpcId(defaultNetwork.id())
.build());
var defaultSecurityGroupRule = new SecurityGroupRule("defaultSecurityGroupRule", SecurityGroupRuleArgs.builder()
.type("ingress")
.ipProtocol("tcp")
.nicType("intranet")
.policy("accept")
.portRange("22/22")
.priority(1)
.securityGroupId(defaultSecurityGroup.id())
.cidrIp("172.16.0.0/24")
.build());
var defaultInstance = new Instance("defaultInstance", InstanceArgs.builder()
.vswitchId(defaultSwitch.id())
.imageId(defaultGetImages.applyValue(getImagesResult -> getImagesResult.images()[0].id()))
.instanceType(defaultGetInstanceTypes.applyValue(getInstanceTypesResult -> getInstanceTypesResult.instanceTypes()[0].id()))
.systemDiskCategory("cloud_efficiency")
.internetChargeType("PayByTraffic")
.internetMaxBandwidthOut(5)
.securityGroups(defaultSecurityGroup.id())
.instanceName(name)
.build());
var defaultCommand = new Command("defaultCommand", CommandArgs.builder()
.name(name)
.commandContent("ZWNobyBoZWxsbyx7e25hbWV9fQ==")
.description("For Terraform Test")
.type("RunShellScript")
.workingDir("/root")
.enableParameter(true)
.build());
var defaultEcsInvocation = new EcsInvocation("defaultEcsInvocation", EcsInvocationArgs.builder()
.commandId(defaultCommand.id())
.instanceIds(defaultInstance.id())
.build());
}
}
configuration:
name:
type: string
default: tf-example
resources:
defaultNetwork:
type: alicloud:vpc:Network
name: default
properties:
vpcName: ${name}
cidrBlock: 172.16.0.0/16
defaultSwitch:
type: alicloud:vpc:Switch
name: default
properties:
vpcId: ${defaultNetwork.id}
cidrBlock: 172.16.0.0/24
zoneId: ${default.zones[0].id}
vswitchName: ${name}
defaultSecurityGroup:
type: alicloud:ecs:SecurityGroup
name: default
properties:
name: ${name}
vpcId: ${defaultNetwork.id}
defaultSecurityGroupRule:
type: alicloud:ecs:SecurityGroupRule
name: default
properties:
type: ingress
ipProtocol: tcp
nicType: intranet
policy: accept
portRange: 22/22
priority: 1
securityGroupId: ${defaultSecurityGroup.id}
cidrIp: 172.16.0.0/24
defaultInstance:
type: alicloud:ecs:Instance
name: default
properties:
vswitchId: ${defaultSwitch.id}
imageId: ${defaultGetImages.images[0].id}
instanceType: ${defaultGetInstanceTypes.instanceTypes[0].id}
systemDiskCategory: cloud_efficiency
internetChargeType: PayByTraffic
internetMaxBandwidthOut: 5
securityGroups:
- ${defaultSecurityGroup.id}
instanceName: ${name}
defaultCommand:
type: alicloud:ecs:Command
name: default
properties:
name: ${name}
commandContent: ZWNobyBoZWxsbyx7e25hbWV9fQ==
description: For Terraform Test
type: RunShellScript
workingDir: /root
enableParameter: true
defaultEcsInvocation:
type: alicloud:ecs:EcsInvocation
name: default
properties:
commandId: ${defaultCommand.id}
instanceIds:
- ${defaultInstance.id}
variables:
default:
fn::invoke:
Function: alicloud:getZones
Arguments:
availableDiskCategory: cloud_efficiency
availableResourceCreation: VSwitch
defaultGetInstanceTypes:
fn::invoke:
Function: alicloud:ecs:getInstanceTypes
Arguments:
availabilityZone: ${default.zones[0].id}
defaultGetImages:
fn::invoke:
Function: alicloud:ecs:getImages
Arguments:
nameRegex: ^ubuntu
mostRecent: true
owners: system
Create EcsInvocation Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new EcsInvocation(name: string, args: EcsInvocationArgs, opts?: CustomResourceOptions);
@overload
def EcsInvocation(resource_name: str,
args: EcsInvocationArgs,
opts: Optional[ResourceOptions] = None)
@overload
def EcsInvocation(resource_name: str,
opts: Optional[ResourceOptions] = None,
command_id: Optional[str] = None,
instance_ids: Optional[Sequence[str]] = None,
frequency: Optional[str] = None,
parameters: Optional[Mapping[str, Any]] = None,
repeat_mode: Optional[str] = None,
timed: Optional[bool] = None,
username: Optional[str] = None,
windows_password_name: Optional[str] = None)
func NewEcsInvocation(ctx *Context, name string, args EcsInvocationArgs, opts ...ResourceOption) (*EcsInvocation, error)
public EcsInvocation(string name, EcsInvocationArgs args, CustomResourceOptions? opts = null)
public EcsInvocation(String name, EcsInvocationArgs args)
public EcsInvocation(String name, EcsInvocationArgs args, CustomResourceOptions options)
type: alicloud:ecs:EcsInvocation
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args EcsInvocationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args EcsInvocationArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args EcsInvocationArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args EcsInvocationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args EcsInvocationArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var ecsInvocationResource = new AliCloud.Ecs.EcsInvocation("ecsInvocationResource", new()
{
CommandId = "string",
InstanceIds = new[]
{
"string",
},
Frequency = "string",
Parameters =
{
{ "string", "any" },
},
RepeatMode = "string",
Timed = false,
Username = "string",
WindowsPasswordName = "string",
});
example, err := ecs.NewEcsInvocation(ctx, "ecsInvocationResource", &ecs.EcsInvocationArgs{
CommandId: pulumi.String("string"),
InstanceIds: pulumi.StringArray{
pulumi.String("string"),
},
Frequency: pulumi.String("string"),
Parameters: pulumi.Map{
"string": pulumi.Any("any"),
},
RepeatMode: pulumi.String("string"),
Timed: pulumi.Bool(false),
Username: pulumi.String("string"),
WindowsPasswordName: pulumi.String("string"),
})
var ecsInvocationResource = new EcsInvocation("ecsInvocationResource", EcsInvocationArgs.builder()
.commandId("string")
.instanceIds("string")
.frequency("string")
.parameters(Map.of("string", "any"))
.repeatMode("string")
.timed(false)
.username("string")
.windowsPasswordName("string")
.build());
ecs_invocation_resource = alicloud.ecs.EcsInvocation("ecsInvocationResource",
command_id="string",
instance_ids=["string"],
frequency="string",
parameters={
"string": "any",
},
repeat_mode="string",
timed=False,
username="string",
windows_password_name="string")
const ecsInvocationResource = new alicloud.ecs.EcsInvocation("ecsInvocationResource", {
commandId: "string",
instanceIds: ["string"],
frequency: "string",
parameters: {
string: "any",
},
repeatMode: "string",
timed: false,
username: "string",
windowsPasswordName: "string",
});
type: alicloud:ecs:EcsInvocation
properties:
commandId: string
frequency: string
instanceIds:
- string
parameters:
string: any
repeatMode: string
timed: false
username: string
windowsPasswordName: string
EcsInvocation Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The EcsInvocation resource accepts the following input properties:
- Command
Id string - The ID of the command.
- Instance
Ids List<string> - The list of instances to execute the command. You can specify up to 50 instance IDs.
- Frequency string
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- Parameters Dictionary<string, object>
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- Repeat
Mode string - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - Timed bool
- Specifies whether to periodically run the command. Default value:
false
. - Username string
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- Windows
Password stringName - The name of the password used to run the command on a Windows instance.
- Command
Id string - The ID of the command.
- Instance
Ids []string - The list of instances to execute the command. You can specify up to 50 instance IDs.
- Frequency string
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- Parameters map[string]interface{}
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- Repeat
Mode string - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - Timed bool
- Specifies whether to periodically run the command. Default value:
false
. - Username string
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- Windows
Password stringName - The name of the password used to run the command on a Windows instance.
- command
Id String - The ID of the command.
- instance
Ids List<String> - The list of instances to execute the command. You can specify up to 50 instance IDs.
- frequency String
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- parameters Map<String,Object>
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- repeat
Mode String - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - timed Boolean
- Specifies whether to periodically run the command. Default value:
false
. - username String
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- windows
Password StringName - The name of the password used to run the command on a Windows instance.
- command
Id string - The ID of the command.
- instance
Ids string[] - The list of instances to execute the command. You can specify up to 50 instance IDs.
- frequency string
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- parameters {[key: string]: any}
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- repeat
Mode string - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - timed boolean
- Specifies whether to periodically run the command. Default value:
false
. - username string
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- windows
Password stringName - The name of the password used to run the command on a Windows instance.
- command_
id str - The ID of the command.
- instance_
ids Sequence[str] - The list of instances to execute the command. You can specify up to 50 instance IDs.
- frequency str
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- parameters Mapping[str, Any]
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- repeat_
mode str - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - timed bool
- Specifies whether to periodically run the command. Default value:
false
. - username str
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- windows_
password_ strname - The name of the password used to run the command on a Windows instance.
- command
Id String - The ID of the command.
- instance
Ids List<String> - The list of instances to execute the command. You can specify up to 50 instance IDs.
- frequency String
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- parameters Map<Any>
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- repeat
Mode String - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - timed Boolean
- Specifies whether to periodically run the command. Default value:
false
. - username String
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- windows
Password StringName - The name of the password used to run the command on a Windows instance.
Outputs
All input properties are implicitly available as output properties. Additionally, the EcsInvocation resource produces the following output properties:
Look up Existing EcsInvocation Resource
Get an existing EcsInvocation resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: EcsInvocationState, opts?: CustomResourceOptions): EcsInvocation
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
command_id: Optional[str] = None,
frequency: Optional[str] = None,
instance_ids: Optional[Sequence[str]] = None,
parameters: Optional[Mapping[str, Any]] = None,
repeat_mode: Optional[str] = None,
status: Optional[str] = None,
timed: Optional[bool] = None,
username: Optional[str] = None,
windows_password_name: Optional[str] = None) -> EcsInvocation
func GetEcsInvocation(ctx *Context, name string, id IDInput, state *EcsInvocationState, opts ...ResourceOption) (*EcsInvocation, error)
public static EcsInvocation Get(string name, Input<string> id, EcsInvocationState? state, CustomResourceOptions? opts = null)
public static EcsInvocation get(String name, Output<String> id, EcsInvocationState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Command
Id string - The ID of the command.
- Frequency string
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- Instance
Ids List<string> - The list of instances to execute the command. You can specify up to 50 instance IDs.
- Parameters Dictionary<string, object>
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- Repeat
Mode string - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - Status string
- The status of the resource.
- Timed bool
- Specifies whether to periodically run the command. Default value:
false
. - Username string
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- Windows
Password stringName - The name of the password used to run the command on a Windows instance.
- Command
Id string - The ID of the command.
- Frequency string
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- Instance
Ids []string - The list of instances to execute the command. You can specify up to 50 instance IDs.
- Parameters map[string]interface{}
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- Repeat
Mode string - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - Status string
- The status of the resource.
- Timed bool
- Specifies whether to periodically run the command. Default value:
false
. - Username string
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- Windows
Password stringName - The name of the password used to run the command on a Windows instance.
- command
Id String - The ID of the command.
- frequency String
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- instance
Ids List<String> - The list of instances to execute the command. You can specify up to 50 instance IDs.
- parameters Map<String,Object>
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- repeat
Mode String - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - status String
- The status of the resource.
- timed Boolean
- Specifies whether to periodically run the command. Default value:
false
. - username String
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- windows
Password StringName - The name of the password used to run the command on a Windows instance.
- command
Id string - The ID of the command.
- frequency string
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- instance
Ids string[] - The list of instances to execute the command. You can specify up to 50 instance IDs.
- parameters {[key: string]: any}
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- repeat
Mode string - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - status string
- The status of the resource.
- timed boolean
- Specifies whether to periodically run the command. Default value:
false
. - username string
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- windows
Password stringName - The name of the password used to run the command on a Windows instance.
- command_
id str - The ID of the command.
- frequency str
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- instance_
ids Sequence[str] - The list of instances to execute the command. You can specify up to 50 instance IDs.
- parameters Mapping[str, Any]
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- repeat_
mode str - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - status str
- The status of the resource.
- timed bool
- Specifies whether to periodically run the command. Default value:
false
. - username str
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- windows_
password_ strname - The name of the password used to run the command on a Windows instance.
- command
Id String - The ID of the command.
- frequency String
- The schedule on which the recurring execution of the command takes place. Take note of the following items:
- The interval between two consecutive executions must be 10 seconds or longer. The minimum interval cannot be less than the timeout period of the execution.
- When you set Timed to true, you must specify Frequency.
- The value of the Frequency parameter is a cron expression. For more information, see Cron expression.
- instance
Ids List<String> - The list of instances to execute the command. You can specify up to 50 instance IDs.
- parameters Map<Any>
- The key-value pairs of custom parameters to be passed in when the custom parameter feature is enabled. Number of custom parameters: 0 to 10.
- repeat
Mode String - Specifies how to run the command. Valid values:
Once
,Period
,NextRebootOnly
,EveryReboot
. Default value: Whentimed
is set to false and Frequency is not specified, the default value ofrepeat_mode
isOnce
. WhenTimed
is set to true and Frequency is specified,period
is used as the value of RepeatMode regardless of whetherrepeat_mode
is specified. - status String
- The status of the resource.
- timed Boolean
- Specifies whether to periodically run the command. Default value:
false
. - username String
- The username that is used to run the command on the ECS instance.
- For Linux instances, the root username is used.
- For Windows instances, the System username is used.
- You can also specify other usernames that already exist in the ECS instance to run the command. It is more secure to run Cloud Assistant commands as a regular user. For more information, see Configure a regular user to run Cloud Assistant commands.
- windows
Password StringName - The name of the password used to run the command on a Windows instance.
Import
ECS Invocation can be imported using the id, e.g.
$ pulumi import alicloud:ecs/ecsInvocation:EcsInvocation example <id>
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Alibaba Cloud pulumi/pulumi-alicloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
alicloud
Terraform Provider.