RosInstance

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

Initializers

import { datasource } from '@alicloud/ros-cdk-ecs'
new datasource.RosInstance(scope: Construct, id: string, props: RosInstanceProps, enableResourcePropertyConstraint: boolean)

Name	Type	Description
scope	@alicloud/ros-cdk-core.Construct	- scope in which this resource is defined.
id	string	- scoped id of the resource.
props	RosInstanceProps	- resource properties.
enableResourcePropertyConstraint	boolean	No description.

---

scope^Required

• Type: @alicloud/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: boolean

---

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

public toString(): string

Returns a string representation of this construct.

synthesize

public synthesize(session: ISynthesisSession): void

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: @alicloud/ros-cdk-core.ISynthesisSession

The synthesis session.

---

overrideLogicalId

public overrideLogicalId(newLogicalId: string): void

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

public addCondition(con: RosCondition): void

con^Required

• Type: @alicloud/ros-cdk-core.RosCondition

---

addCount

public addCount(count: number | IResolvable): void

count^Required

• Type: number | @alicloud/ros-cdk-core.IResolvable

---

addDeletionOverride

public addDeletionOverride(path: string): void

Syntactic sugar for addOverride(path, undefined).

path^Required

• Type: string

The path of the value to delete.

---

addDependsOn

public addDependsOn(target: RosResource): void

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: @alicloud/ros-cdk-core.RosResource

---

addDesc

public addDesc(desc: string): void

desc^Required

• Type: string

---

addMetaData

public addMetaData(key: string, value: any): void

key^Required

• Type: string

---

value^Required

• Type: any

---

addOverride

public addOverride(path: string, value: any): void

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: any

The value.

Could be primitive or complex.

---

addPropertyDeletionOverride

public addPropertyDeletionOverride(propertyPath: string): void

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

propertyPath^Required

• Type: string

The path to the property.

---

addPropertyOverride

public addPropertyOverride(propertyPath: string, value: any): void

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: any

The value.

---

addRosDependency

public addRosDependency(target: string): void

target^Required

• Type: string

---

applyRemovalPolicy

public applyRemovalPolicy(policy?: RemovalPolicy, options?: RemovalPolicyOptions): void

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

policy^Optional

• Type: @alicloud/ros-cdk-core.RemovalPolicy

---

options^Optional

• Type: @alicloud/ros-cdk-core.RemovalPolicyOptions

---

getAtt

public getAtt(attributeName: string): Reference

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

import { datasource } from '@alicloud/ros-cdk-ecs'
datasource.RosInstance.isConstruct(x: any)

Return whether the given object is a Construct.

x^Required

• Type: any

---

isRosElement

import { datasource } from '@alicloud/ros-cdk-ecs'
datasource.RosInstance.isRosElement(x: any)

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: any

---

isRosResource

import { datasource } from '@alicloud/ros-cdk-ecs'
datasource.RosInstance.isRosResource(construct: IConstruct)

Check whether the given construct is a RosResource.

construct^Required

• Type: @alicloud/ros-cdk-core.IConstruct

---

Properties

Name	Type	Description
node	@alicloud/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	@alicloud/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	@alicloud/ros-cdk-core.IRosResourceOptions	Options for this resource, such as condition, update policy etc.
rosResourceType	string	ROS resource type.
attrActionOnMaintenance	@alicloud/ros-cdk-core.IResolvable	No description.
attrAutoRebootTime	@alicloud/ros-cdk-core.IResolvable	No description.
attrAutoReleaseTime	@alicloud/ros-cdk-core.IResolvable	No description.
attrAutoRenewEnabled	@alicloud/ros-cdk-core.IResolvable	No description.
attrClusterId	@alicloud/ros-cdk-core.IResolvable	No description.
attrCpu	@alicloud/ros-cdk-core.IResolvable	No description.
attrCpuOptions	@alicloud/ros-cdk-core.IResolvable	No description.
attrCreateTime	@alicloud/ros-cdk-core.IResolvable	No description.
attrCreditSpecification	@alicloud/ros-cdk-core.IResolvable	No description.
attrDedicatedHostAttribute	@alicloud/ros-cdk-core.IResolvable	No description.
attrDedicatedInstanceAttribute	@alicloud/ros-cdk-core.IResolvable	No description.
attrDeletionProtection	@alicloud/ros-cdk-core.IResolvable	No description.
attrDeploymentSetGroupNo	@alicloud/ros-cdk-core.IResolvable	No description.
attrDeploymentSetId	@alicloud/ros-cdk-core.IResolvable	No description.
attrDescription	@alicloud/ros-cdk-core.IResolvable	No description.
attrDeviceAvailable	@alicloud/ros-cdk-core.IResolvable	No description.
attrDuration	@alicloud/ros-cdk-core.IResolvable	No description.
attrEcsCapacityReservationAttr	@alicloud/ros-cdk-core.IResolvable	No description.
attrEipAddress	@alicloud/ros-cdk-core.IResolvable	No description.
attrExpiredTime	@alicloud/ros-cdk-core.IResolvable	No description.
attrGpuAmount	@alicloud/ros-cdk-core.IResolvable	No description.
attrGpuSpec	@alicloud/ros-cdk-core.IResolvable	No description.
attrHostName	@alicloud/ros-cdk-core.IResolvable	No description.
attrHpcClusterId	@alicloud/ros-cdk-core.IResolvable	No description.
attrImageId	@alicloud/ros-cdk-core.IResolvable	No description.
attrInstanceId	@alicloud/ros-cdk-core.IResolvable	No description.
attrInstanceName	@alicloud/ros-cdk-core.IResolvable	No description.
attrInstanceNetworkType	@alicloud/ros-cdk-core.IResolvable	No description.
attrInstanceType	@alicloud/ros-cdk-core.IResolvable	No description.
attrInstanceTypeFamily	@alicloud/ros-cdk-core.IResolvable	No description.
attrInternetChargeType	@alicloud/ros-cdk-core.IResolvable	No description.
attrInternetMaxBandwidthIn	@alicloud/ros-cdk-core.IResolvable	No description.
attrInternetMaxBandwidthOut	@alicloud/ros-cdk-core.IResolvable	No description.
attrIoOptimized	@alicloud/ros-cdk-core.IResolvable	No description.
attrKeyPairName	@alicloud/ros-cdk-core.IResolvable	No description.
attrLocalStorageAmount	@alicloud/ros-cdk-core.IResolvable	No description.
attrLocalStorageCapacity	@alicloud/ros-cdk-core.IResolvable	No description.
attrMaintenanceWindows	@alicloud/ros-cdk-core.IResolvable	No description.
attrMemory	@alicloud/ros-cdk-core.IResolvable	No description.
attrMetadataOptions	@alicloud/ros-cdk-core.IResolvable	No description.
attrNetworkInterfaces	@alicloud/ros-cdk-core.IResolvable	No description.
attrNotifyOnMaintenance	@alicloud/ros-cdk-core.IResolvable	No description.
attrOperationLocks	@alicloud/ros-cdk-core.IResolvable	No description.
attrOsName	@alicloud/ros-cdk-core.IResolvable	No description.
attrOsNameEn	@alicloud/ros-cdk-core.IResolvable	No description.
attrOsType	@alicloud/ros-cdk-core.IResolvable	No description.
attrPaymentType	@alicloud/ros-cdk-core.IResolvable	No description.
attrPeriodUnit	@alicloud/ros-cdk-core.IResolvable	No description.
attrPrivatePoolOptionsId	@alicloud/ros-cdk-core.IResolvable	No description.
attrPrivatePoolOptionsMatchCriteria	@alicloud/ros-cdk-core.IResolvable	No description.
attrPublicIpAddress	@alicloud/ros-cdk-core.IResolvable	No description.
attrRdmaIpAddress	@alicloud/ros-cdk-core.IResolvable	No description.
attrRecyclable	@alicloud/ros-cdk-core.IResolvable	No description.
attrRenewalStatus	@alicloud/ros-cdk-core.IResolvable	No description.
attrResourceGroupId	@alicloud/ros-cdk-core.IResolvable	No description.
attrSaleCycle	@alicloud/ros-cdk-core.IResolvable	No description.
attrSecurityGroupIds	@alicloud/ros-cdk-core.IResolvable	No description.
attrSerialNumber	@alicloud/ros-cdk-core.IResolvable	No description.
attrSpotDuration	@alicloud/ros-cdk-core.IResolvable	No description.
attrSpotPriceLimit	@alicloud/ros-cdk-core.IResolvable	No description.
attrSpotStrategy	@alicloud/ros-cdk-core.IResolvable	No description.
attrStartTime	@alicloud/ros-cdk-core.IResolvable	No description.
attrStoppedMode	@alicloud/ros-cdk-core.IResolvable	No description.
attrTags	@alicloud/ros-cdk-core.IResolvable	No description.
attrUserData	@alicloud/ros-cdk-core.IResolvable	No description.
attrVpcAttributes	@alicloud/ros-cdk-core.IResolvable	No description.
attrZoneId	@alicloud/ros-cdk-core.IResolvable	No description.
enableResourcePropertyConstraint	boolean	No description.
instanceId	string | @alicloud/ros-cdk-core.IResolvable	No description.
refreshOptions	string | @alicloud/ros-cdk-core.IResolvable	No description.

---

node^Required

public readonly node: ConstructNode;

• Type: @alicloud/ros-cdk-core.ConstructNode

The construct tree node associated with this construct.

---

creationStack^Required

public readonly creationStack: string[];

• Type: string[]

---

logicalId^Required

public readonly logicalId: string;

• 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 readonly stack: Stack;

• Type: @alicloud/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 readonly ref: string;

• 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 readonly rosOptions: IRosResourceOptions;

• Type: @alicloud/ros-cdk-core.IRosResourceOptions

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

---

rosResourceType^Required

public readonly rosResourceType: string;

• Type: string

ROS resource type.

---

attrActionOnMaintenance^Required

public readonly attrActionOnMaintenance: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrAutoRebootTime^Required

public readonly attrAutoRebootTime: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrAutoReleaseTime^Required

public readonly attrAutoReleaseTime: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrAutoRenewEnabled^Required

public readonly attrAutoRenewEnabled: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrClusterId^Required

public readonly attrClusterId: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrCpu^Required

public readonly attrCpu: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrCpuOptions^Required

public readonly attrCpuOptions: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrCreateTime^Required

public readonly attrCreateTime: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrCreditSpecification^Required

public readonly attrCreditSpecification: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrDedicatedHostAttribute^Required

public readonly attrDedicatedHostAttribute: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrDedicatedInstanceAttribute^Required

public readonly attrDedicatedInstanceAttribute: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrDeletionProtection^Required

public readonly attrDeletionProtection: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrDeploymentSetGroupNo^Required

public readonly attrDeploymentSetGroupNo: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrDeploymentSetId^Required

public readonly attrDeploymentSetId: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrDescription^Required

public readonly attrDescription: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrDeviceAvailable^Required

public readonly attrDeviceAvailable: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrDuration^Required

public readonly attrDuration: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrEcsCapacityReservationAttr^Required

public readonly attrEcsCapacityReservationAttr: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrEipAddress^Required

public readonly attrEipAddress: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrExpiredTime^Required

public readonly attrExpiredTime: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrGpuAmount^Required

public readonly attrGpuAmount: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrGpuSpec^Required

public readonly attrGpuSpec: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrHostName^Required

public readonly attrHostName: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrHpcClusterId^Required

public readonly attrHpcClusterId: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrImageId^Required

public readonly attrImageId: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrInstanceId^Required

public readonly attrInstanceId: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrInstanceName^Required

public readonly attrInstanceName: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrInstanceNetworkType^Required

public readonly attrInstanceNetworkType: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrInstanceType^Required

public readonly attrInstanceType: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrInstanceTypeFamily^Required

public readonly attrInstanceTypeFamily: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrInternetChargeType^Required

public readonly attrInternetChargeType: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrInternetMaxBandwidthIn^Required

public readonly attrInternetMaxBandwidthIn: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrInternetMaxBandwidthOut^Required

public readonly attrInternetMaxBandwidthOut: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrIoOptimized^Required

public readonly attrIoOptimized: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrKeyPairName^Required

public readonly attrKeyPairName: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrLocalStorageAmount^Required

public readonly attrLocalStorageAmount: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrLocalStorageCapacity^Required

public readonly attrLocalStorageCapacity: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrMaintenanceWindows^Required

public readonly attrMaintenanceWindows: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrMemory^Required

public readonly attrMemory: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrMetadataOptions^Required

public readonly attrMetadataOptions: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrNetworkInterfaces^Required

public readonly attrNetworkInterfaces: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrNotifyOnMaintenance^Required

public readonly attrNotifyOnMaintenance: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrOperationLocks^Required

public readonly attrOperationLocks: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrOsName^Required

public readonly attrOsName: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrOsNameEn^Required

public readonly attrOsNameEn: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrOsType^Required

public readonly attrOsType: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrPaymentType^Required

public readonly attrPaymentType: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrPeriodUnit^Required

public readonly attrPeriodUnit: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrPrivatePoolOptionsId^Required

public readonly attrPrivatePoolOptionsId: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrPrivatePoolOptionsMatchCriteria^Required

public readonly attrPrivatePoolOptionsMatchCriteria: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrPublicIpAddress^Required

public readonly attrPublicIpAddress: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrRdmaIpAddress^Required

public readonly attrRdmaIpAddress: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrRecyclable^Required

public readonly attrRecyclable: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrRenewalStatus^Required

public readonly attrRenewalStatus: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrResourceGroupId^Required

public readonly attrResourceGroupId: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrSaleCycle^Required

public readonly attrSaleCycle: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrSecurityGroupIds^Required

public readonly attrSecurityGroupIds: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrSerialNumber^Required

public readonly attrSerialNumber: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrSpotDuration^Required

public readonly attrSpotDuration: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrSpotPriceLimit^Required

public readonly attrSpotPriceLimit: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrSpotStrategy^Required

public readonly attrSpotStrategy: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrStartTime^Required

public readonly attrStartTime: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrStoppedMode^Required

public readonly attrStoppedMode: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrTags^Required

public readonly attrTags: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrUserData^Required

public readonly attrUserData: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrVpcAttributes^Required

public readonly attrVpcAttributes: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

attrZoneId^Required

public readonly attrZoneId: IResolvable;

• Type: @alicloud/ros-cdk-core.IResolvable

---

enableResourcePropertyConstraint^Required

public readonly enableResourcePropertyConstraint: boolean;

• Type: boolean

---

instanceId^Required

public readonly instanceId: string | IResolvable;

• Type: string | @alicloud/ros-cdk-core.IResolvable

---

refreshOptions^Optional

public readonly refreshOptions: string | IResolvable;

• Type: string | @alicloud/ros-cdk-core.IResolvable

---

Constants

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

---

ROS_RESOURCE_TYPE_NAME^Required

public readonly ROS_RESOURCE_TYPE_NAME: string;

• Type: string

The resource type name for this resource class.

---