CfnServiceProps
- class aws_cdk.aws_servicediscovery.CfnServiceProps(*, description=None, dns_config=None, health_check_config=None, health_check_custom_config=None, name=None, namespace_id=None, service_attributes=None, tags=None, type=None)
Bases:
object
Properties for defining a
CfnService
.- Parameters:
description (
Optional
[str
]) – The description of the service.dns_config (
Union
[IResolvable
,DnsConfigProperty
,Dict
[str
,Any
],None
]) – A complex type that contains information about the Route 53 DNS records that you want AWS Cloud Map to create when you register an instance. .. epigraph:: The record types of a service can only be changed by deleting the service and recreating it with a newDnsconfig
.health_check_config (
Union
[IResolvable
,HealthCheckConfigProperty
,Dict
[str
,Any
],None
]) – Public DNS and HTTP namespaces only. A complex type that contains settings for an optional health check. If you specify settings for a health check, AWS Cloud Map associates the health check with the records that you specify inDnsConfig
. For information about the charges for health checks, see Amazon Route 53 Pricing .health_check_custom_config (
Union
[IResolvable
,HealthCheckCustomConfigProperty
,Dict
[str
,Any
],None
]) – A complex type that contains information about an optional custom health check. .. epigraph:: If you specify a health check configuration, you can specify eitherHealthCheckCustomConfig
orHealthCheckConfig
but not both.name (
Optional
[str
]) – The name of the service.namespace_id (
Optional
[str
]) – The ID or Amazon Resource Name (ARN) of the namespace that you want to use to create the service. For namespaces shared with your AWS account, specify the namespace ARN. For more information about shared namespaces, see Cross-account AWS Cloud Map namespace sharing in the AWS Cloud Map Developer Guide .service_attributes (
Any
) – A complex type that contains information about attributes associated with a specific service.tags (
Optional
[Sequence
[Union
[CfnTag
,Dict
[str
,Any
]]]]) – The tags for the service. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.type (
Optional
[str
]) – If present, specifies that the service instances are only discoverable using theDiscoverInstances
API operation. No DNS records is registered for the service instances. The only valid value isHTTP
.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_servicediscovery as servicediscovery # service_attributes: Any cfn_service_props = servicediscovery.CfnServiceProps( description="description", dns_config=servicediscovery.CfnService.DnsConfigProperty( dns_records=[servicediscovery.CfnService.DnsRecordProperty( ttl=123, type="type" )], # the properties below are optional namespace_id="namespaceId", routing_policy="routingPolicy" ), health_check_config=servicediscovery.CfnService.HealthCheckConfigProperty( type="type", # the properties below are optional failure_threshold=123, resource_path="resourcePath" ), health_check_custom_config=servicediscovery.CfnService.HealthCheckCustomConfigProperty( failure_threshold=123 ), name="name", namespace_id="namespaceId", service_attributes=service_attributes, tags=[CfnTag( key="key", value="value" )], type="type" )
Attributes
- description
The description of the service.
- dns_config
A complex type that contains information about the Route 53 DNS records that you want AWS Cloud Map to create when you register an instance.
The record types of a service can only be changed by deleting the service and recreating it with a new
Dnsconfig
.
- health_check_config
Public DNS and HTTP namespaces only. A complex type that contains settings for an optional health check. If you specify settings for a health check, AWS Cloud Map associates the health check with the records that you specify in
DnsConfig
.For information about the charges for health checks, see Amazon Route 53 Pricing .
- health_check_custom_config
A complex type that contains information about an optional custom health check.
If you specify a health check configuration, you can specify either
HealthCheckCustomConfig
orHealthCheckConfig
but not both.
- name
The name of the service.
- namespace_id
The ID or Amazon Resource Name (ARN) of the namespace that you want to use to create the service.
For namespaces shared with your AWS account, specify the namespace ARN. For more information about shared namespaces, see Cross-account AWS Cloud Map namespace sharing in the AWS Cloud Map Developer Guide .
- service_attributes
A complex type that contains information about attributes associated with a specific service.
- tags
The tags for the service.
Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.
- type
If present, specifies that the service instances are only discoverable using the
DiscoverInstances
API operation.No DNS records is registered for the service instances. The only valid value is
HTTP
.