Interface CfnService.IServiceConnectClientAliasProperty
Each alias ("endpoint") is a fully-qualified name and port number that other tasks ("clients") can use to connect to this service.
Namespace: Amazon.CDK.AWS.ECS
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public interface IServiceConnectClientAliasProperty
Syntax (vb)
Public Interface IServiceConnectClientAliasProperty
Remarks
Each name and port mapping must be unique within the namespace.
Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide .
ExampleMetadata: fixture=_generated
Examples
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.ECS;
var serviceConnectClientAliasProperty = new ServiceConnectClientAliasProperty {
Port = 123,
// the properties below are optional
DnsName = "dnsName"
};
Synopsis
Properties
DnsName | The |
Port | The listening port number for the Service Connect proxy. |
Properties
DnsName
The dnsName
is the name that you use in the applications of client tasks to connect to this service.
virtual string DnsName { get; }
Property Value
System.String
Remarks
The name must be a valid DNS name but doesn't need to be fully-qualified. The name can include up to 127 characters. The name can include lowercase letters, numbers, underscores (_), hyphens (-), and periods (.). The name can't start with a hyphen.
If this parameter isn't specified, the default value of discoveryName.namespace
is used. If the discoveryName
isn't specified, the port mapping name from the task definition is used in portName.namespace
.
To avoid changing your applications in client Amazon ECS services, set this to the same name that the client application uses by default. For example, a few common names are database
, db
, or the lowercase name of a database, such as mysql
or redis
. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide .
Port
The listening port number for the Service Connect proxy.
double Port { get; }
Property Value
System.Double
Remarks
This port is available inside of all of the tasks within the same namespace.
To avoid changing your applications in client Amazon ECS services, set this to the same port that the client application uses by default. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide .