RosInstance

This class is a base encapsulation around the ROS resource type ALIYUN::ECS::Instance, which is used to create an Elastic Compute Service (ECS) instance.

Initializers

using AlibabaCloud.SDK.ROS.CDK.Ecs;
new RosInstance(Construct Scope, string Id, RosInstanceProps Props, bool EnableResourcePropertyConstraint);

Name	Type	Description
Scope	AlibabaCloud.SDK.ROS.CDK.Core.Construct	- scope in which this resource is defined.
Id	string	- scoped id of the resource.
Props	RosInstanceProps	- resource properties.
EnableResourcePropertyConstraint	bool	No description.

---

Scope^Required

• Type: AlibabaCloud.SDK.ROS.CDK.Core.Construct

scope in which this resource is defined.

---

Id^Required

• Type: string

scoped id of the resource.

---

Props^Required

• Type: RosInstanceProps

resource properties.

---

EnableResourcePropertyConstraint^Required

• Type: bool

---

Methods

Name	Description
ToString	Returns a string representation of this construct.
Synthesize	Allows this construct to emit artifacts into the cloud assembly during synthesis.
OverrideLogicalId	Overrides the auto-generated logical ID with a specific ID.
AddCondition	No description.
AddCount	No description.
AddDeletionOverride	Syntactic sugar for addOverride(path, undefined).
AddDependsOn	Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.
AddDesc	No description.
AddMetaData	No description.
AddOverride	Adds an override to the synthesized ROS resource.
AddPropertyDeletionOverride	Adds an override that deletes the value of a property from the resource definition.
AddPropertyOverride	Adds an override to a resource property.
AddRosDependency	No description.
ApplyRemovalPolicy	Sets the deletion policy of the resource based on the removal policy specified.
GetAtt	Returns a token for an runtime attribute of this resource.

---

ToString

private string ToString()

Returns a string representation of this construct.

Synthesize

private void Synthesize(ISynthesisSession Session)

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

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

Session^Required

• Type: AlibabaCloud.SDK.ROS.CDK.Core.ISynthesisSession

The synthesis session.

---

OverrideLogicalId

private void OverrideLogicalId(string NewLogicalId)

Overrides the auto-generated logical ID with a specific ID.

NewLogicalId^Required

• Type: string

The new logical ID to use for this stack element.

---

AddCondition

private void AddCondition(RosCondition Con)

Con^Required

• Type: AlibabaCloud.SDK.ROS.CDK.Core.RosCondition

---

AddCount

private void AddCount(object Count)

Count^Required

• Type: object

---

AddDeletionOverride

private void AddDeletionOverride(string Path)

Syntactic sugar for addOverride(path, undefined).

Path^Required

• Type: string

The path of the value to delete.

---

AddDependsOn

private void AddDependsOn(RosResource Target)

Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.

This can be used for resources across stacks (or nested stack) boundaries and the dependency will automatically be transferred to the relevant scope.

Target^Required

• Type: AlibabaCloud.SDK.ROS.CDK.Core.RosResource

---

AddDesc

private void AddDesc(string Desc)

Desc^Required

• Type: string

---

AddMetaData

private void AddMetaData(string Key, object Value)

Key^Required

• Type: string

---

Value^Required

• Type: object

---

AddOverride

private void AddOverride(string Path, object Value)

Adds an override to the synthesized ROS resource.

To add a property override, either use addPropertyOverride or prefix path with "Properties." (i.e. Properties.TopicName).

If the override is nested, separate each nested level using a dot (.) in the path parameter. If there is an array as part of the nesting, specify the index in the path.

For example,

addOverride('Properties.GlobalSecondaryIndexes.0.Projection.NonKeyAttributes', ['myattribute'])
addOverride('Properties.GlobalSecondaryIndexes.1.ProjectionType', 'INCLUDE')

would add the overrides

"Properties": {
   "GlobalSecondaryIndexes": [
     {
       "Projection": {
         "NonKeyAttributes": [ "myattribute" ]
         ...
       }
       ...
     },
     {
       "ProjectionType": "INCLUDE"
       ...
     },
   ]
   ...
}

Path^Required

• Type: string

The path of the property, you can use dot notation to override values in complex types.

Any intermdediate keys will be created as needed.

---

Value^Required

• Type: object

The value.

Could be primitive or complex.

---

AddPropertyDeletionOverride

private void AddPropertyDeletionOverride(string PropertyPath)

Adds an override that deletes the value of a property from the resource definition.

PropertyPath^Required

• Type: string

The path to the property.

---

AddPropertyOverride

private void AddPropertyOverride(string PropertyPath, object Value)

Adds an override to a resource property.

Syntactic sugar for addOverride("Properties.<...>", value).

PropertyPath^Required

• Type: string

The path of the property.

---

Value^Required

• Type: object

The value.

---

AddRosDependency

private void AddRosDependency(string Target)

Target^Required

• Type: string

---

ApplyRemovalPolicy

private void ApplyRemovalPolicy(RemovalPolicy Policy = null, RemovalPolicyOptions Options = null)

Sets the deletion policy of the resource based on the removal policy specified.

Policy^Optional

• Type: AlibabaCloud.SDK.ROS.CDK.Core.RemovalPolicy

---

Options^Optional

• Type: AlibabaCloud.SDK.ROS.CDK.Core.RemovalPolicyOptions

---

GetAtt

private Reference GetAtt(string AttributeName)

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility in case there is no generated attribute.

AttributeName^Required

• Type: string

The name of the attribute.

---

Static Functions

Name	Description
IsConstruct	Return whether the given object is a Construct.
IsRosElement	Returns true if a construct is a stack element (i.e. part of the synthesized template).
IsRosResource	Check whether the given construct is a RosResource.

---

IsConstruct

using AlibabaCloud.SDK.ROS.CDK.Ecs;
RosInstance.IsConstruct(object X);

Return whether the given object is a Construct.

X^Required

• Type: object

---

IsRosElement

using AlibabaCloud.SDK.ROS.CDK.Ecs;
RosInstance.IsRosElement(object X);

Returns true if a construct is a stack element (i.e. part of the synthesized template).

Uses duck-typing instead of instanceof to allow stack elements from different versions of this library to be included in the same stack.

X^Required

• Type: object

---

IsRosResource

using AlibabaCloud.SDK.ROS.CDK.Ecs;
RosInstance.IsRosResource(IConstruct Construct);

Check whether the given construct is a RosResource.

Construct^Required

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IConstruct

---

Properties

Name	Type	Description
Node	AlibabaCloud.SDK.ROS.CDK.Core.ConstructNode	The construct tree node associated with this construct.
CreationStack	string[]	No description.
LogicalId	string	The logical ID for this stack element.
Stack	AlibabaCloud.SDK.ROS.CDK.Core.Stack	The stack in which this element is defined.
Ref	string	Return a string that will be resolved to a RosTemplate { Ref } for this element.
RosOptions	AlibabaCloud.SDK.ROS.CDK.Core.IRosResourceOptions	Options for this resource, such as condition, update policy etc.
RosResourceType	string	ROS resource type.
AttrHostName	AlibabaCloud.SDK.ROS.CDK.Core.IResolvable	No description.
AttrInnerIp	AlibabaCloud.SDK.ROS.CDK.Core.IResolvable	No description.
AttrInstanceId	AlibabaCloud.SDK.ROS.CDK.Core.IResolvable	No description.
AttrPrimaryNetworkInterfaceId	AlibabaCloud.SDK.ROS.CDK.Core.IResolvable	No description.
AttrPrivateIp	AlibabaCloud.SDK.ROS.CDK.Core.IResolvable	No description.
AttrPublicIp	AlibabaCloud.SDK.ROS.CDK.Core.IResolvable	No description.
AttrSecurityGroupIds	AlibabaCloud.SDK.ROS.CDK.Core.IResolvable	No description.
AttrZoneId	AlibabaCloud.SDK.ROS.CDK.Core.IResolvable	No description.
EnableResourcePropertyConstraint	bool	No description.
InstanceType	object	No description.
Affinity	object	No description.
AllocatePublicIp	object	No description.
AutoRenew	object	No description.
AutoRenewPeriod	object	No description.
CreditSpecification	object	No description.
DedicatedHostId	object	No description.
DeletionProtection	object	No description.
DeploymentSetGroupNo	object	No description.
DeploymentSetId	object	No description.
Description	object	No description.
DiskMappings	object	No description.
HostName	object	No description.
HpcClusterId	object	No description.
HttpEndpoint	object	No description.
HttpTokens	object	No description.
ImageFamily	object	No description.
ImageId	object	No description.
InstanceChargeType	object	No description.
InstanceName	object	No description.
InternetChargeType	object	No description.
InternetMaxBandwidthOut	object	No description.
IoOptimized	object	No description.
KeyPairName	object	No description.
Password	object	No description.
PasswordInherit	object	No description.
Period	object	No description.
PeriodUnit	object	No description.
PrivateIpAddress	object	No description.
PrivatePoolOptions	object	No description.
RamRoleName	object	No description.
ResourceGroupId	object	No description.
SecurityEnhancementStrategy	object	No description.
SecurityGroupId	object	No description.
SecurityGroupIds	object	No description.
SpotDuration	object	No description.
SpotInterruptionBehavior	object	No description.
SpotPriceLimit	object	No description.
SpotStrategy	object	No description.
StorageSetId	object	No description.
StorageSetPartitionNumber	object	No description.
SystemDiskCategory	object	No description.
SystemDiskDescription	object	No description.
SystemDiskDiskName	object	No description.
SystemDiskPerformanceLevel	object	No description.
SystemDiskSize	object	No description.
Tags	TagsProperty[]	No description.
Tenancy	object	No description.
UseAdditionalService	object	No description.
UserData	object	No description.
VpcId	object	No description.
VSwitchId	object	No description.
ZoneId	object	No description.
ZoneIds	object	No description.

---

Node^Required

public ConstructNode Node { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.ConstructNode

The construct tree node associated with this construct.

---

CreationStack^Required

public string[] CreationStack { get; }

• Type: string[]

---

LogicalId^Required

public string LogicalId { get; }

• Type: string

The logical ID for this stack element.

The logical ID of the element is calculated from the path of the resource node in the construct tree.

To override this value, use overrideLogicalId(newLogicalId).

---

Stack^Required

public Stack Stack { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.Stack

The stack in which this element is defined.

RosElements must be defined within a stack scope (directly or indirectly).

---

Ref^Required

public string Ref { get; }

• Type: string

Return a string that will be resolved to a RosTemplate { Ref } for this element.

If, by any chance, the intrinsic reference of a resource is not a string, you could coerce it to an IResolvable through Lazy.any({ produce: resource.ref }).

---

RosOptions^Required

public IRosResourceOptions RosOptions { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IRosResourceOptions

Options for this resource, such as condition, update policy etc.

---

RosResourceType^Required

public string RosResourceType { get; }

• Type: string

ROS resource type.

---

AttrHostName^Required

public IResolvable AttrHostName { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IResolvable

---

AttrInnerIp^Required

public IResolvable AttrInnerIp { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IResolvable

---

AttrInstanceId^Required

public IResolvable AttrInstanceId { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IResolvable

---

AttrPrimaryNetworkInterfaceId^Required

public IResolvable AttrPrimaryNetworkInterfaceId { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IResolvable

---

AttrPrivateIp^Required

public IResolvable AttrPrivateIp { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IResolvable

---

AttrPublicIp^Required

public IResolvable AttrPublicIp { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IResolvable

---

AttrSecurityGroupIds^Required

public IResolvable AttrSecurityGroupIds { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IResolvable

---

AttrZoneId^Required

public IResolvable AttrZoneId { get; }

• Type: AlibabaCloud.SDK.ROS.CDK.Core.IResolvable

---

EnableResourcePropertyConstraint^Required

public bool EnableResourcePropertyConstraint { get; }

• Type: bool

---

InstanceType^Required

public object InstanceType { get; }

• Type: object

---

Affinity^Optional

public object Affinity { get; }

• Type: object

---

AllocatePublicIp^Optional

public object AllocatePublicIp { get; }

• Type: object

---

AutoRenew^Optional

public object AutoRenew { get; }

• Type: object

---

AutoRenewPeriod^Optional

public object AutoRenewPeriod { get; }

• Type: object

---

CreditSpecification^Optional

public object CreditSpecification { get; }

• Type: object

---

DedicatedHostId^Optional

public object DedicatedHostId { get; }

• Type: object

---

DeletionProtection^Optional

public object DeletionProtection { get; }

• Type: object

---

DeploymentSetGroupNo^Optional

public object DeploymentSetGroupNo { get; }

• Type: object

---

DeploymentSetId^Optional

public object DeploymentSetId { get; }

• Type: object

---

Description^Optional

public object Description { get; }

• Type: object

---

DiskMappings^Optional

public object DiskMappings { get; }

• Type: object

---

HostName^Optional

public object HostName { get; }

• Type: object

---

HpcClusterId^Optional

public object HpcClusterId { get; }

• Type: object

---

HttpEndpoint^Optional

public object HttpEndpoint { get; }

• Type: object

---

HttpTokens^Optional

public object HttpTokens { get; }

• Type: object

---

ImageFamily^Optional

public object ImageFamily { get; }

• Type: object

---

ImageId^Optional

public object ImageId { get; }

• Type: object

---

InstanceChargeType^Optional

public object InstanceChargeType { get; }

• Type: object

---

InstanceName^Optional

public object InstanceName { get; }

• Type: object

---

InternetChargeType^Optional

public object InternetChargeType { get; }

• Type: object

---

InternetMaxBandwidthOut^Optional

public object InternetMaxBandwidthOut { get; }

• Type: object

---

IoOptimized^Optional

public object IoOptimized { get; }

• Type: object

---

KeyPairName^Optional

public object KeyPairName { get; }

• Type: object

---

Password^Optional

public object Password { get; }

• Type: object

---

PasswordInherit^Optional

public object PasswordInherit { get; }

• Type: object

---

Period^Optional

public object Period { get; }

• Type: object

---

PeriodUnit^Optional

public object PeriodUnit { get; }

• Type: object

---

PrivateIpAddress^Optional

public object PrivateIpAddress { get; }

• Type: object

---

PrivatePoolOptions^Optional

public object PrivatePoolOptions { get; }

• Type: object

---

RamRoleName^Optional

public object RamRoleName { get; }

• Type: object

---

ResourceGroupId^Optional

public object ResourceGroupId { get; }

• Type: object

---

SecurityEnhancementStrategy^Optional

public object SecurityEnhancementStrategy { get; }

• Type: object

---

SecurityGroupId^Optional

public object SecurityGroupId { get; }

• Type: object

---

SecurityGroupIds^Optional

public object SecurityGroupIds { get; }

• Type: object

---

SpotDuration^Optional

public object SpotDuration { get; }

• Type: object

---

SpotInterruptionBehavior^Optional

public object SpotInterruptionBehavior { get; }

• Type: object

---

SpotPriceLimit^Optional

public object SpotPriceLimit { get; }

• Type: object

---

SpotStrategy^Optional

public object SpotStrategy { get; }

• Type: object

---

StorageSetId^Optional

public object StorageSetId { get; }

• Type: object

---

StorageSetPartitionNumber^Optional

public object StorageSetPartitionNumber { get; }

• Type: object

---

SystemDiskCategory^Optional

public object SystemDiskCategory { get; }

• Type: object

---

SystemDiskDescription^Optional

public object SystemDiskDescription { get; }

• Type: object

---

SystemDiskDiskName^Optional

public object SystemDiskDiskName { get; }

• Type: object

---

SystemDiskPerformanceLevel^Optional

public object SystemDiskPerformanceLevel { get; }

• Type: object

---

SystemDiskSize^Optional

public object SystemDiskSize { get; }

• Type: object

---

Tags^Optional

public TagsProperty[] Tags { get; }

• Type: TagsProperty[]

---

Tenancy^Optional

public object Tenancy { get; }

• Type: object

---

UseAdditionalService^Optional

public object UseAdditionalService { get; }

• Type: object

---

UserData^Optional

public object UserData { get; }

• Type: object

---

VpcId^Optional

public object VpcId { get; }

• Type: object

---

VSwitchId^Optional

public object VSwitchId { get; }

• Type: object

---

ZoneId^Optional

public object ZoneId { get; }

• Type: object

---

ZoneIds^Optional

public object ZoneIds { get; }

• Type: object

---

Constants

Name	Type	Description
RosResourceTypeName	string	The resource type name for this resource class.

---

RosResourceTypeName^Required

public string RosResourceTypeName { get; }

• Type: string

The resource type name for this resource class.

---