Learn R Programming

paws (version 0.1.12)

servicediscovery: AWS Cloud Map

Description

AWS Cloud Map lets you configure public DNS, private DNS, or HTTP namespaces that your microservice applications run in. When an instance of the service becomes available, you can call the AWS Cloud Map API to register the instance with AWS Cloud Map. For public or private DNS namespaces, AWS Cloud Map automatically creates DNS records and an optional health check. Clients that submit public or private DNS queries, or HTTP requests, for the service receive an answer that contains up to eight healthy records.

Usage

servicediscovery(config = list())

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

Service syntax

svc <- servicediscovery(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string"
    ),
    endpoint = "string",
    region = "string"
  )
)

Operations

create_http_namespaceCreates an HTTP namespace
create_private_dns_namespaceCreates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC
create_public_dns_namespaceCreates a public namespace based on DNS, which will be visible on the internet
create_serviceCreates a service, which defines the configuration for the following entities:
delete_namespaceDeletes a namespace from the current account
delete_serviceDeletes a specified service
deregister_instanceDeletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified instance
discover_instancesDiscovers registered instances for a specified namespace and service
get_instanceGets information about a specified instance
get_instances_health_statusGets the current health status (Healthy, Unhealthy, or Unknown) of one or more instances that are associated with a specified service
get_namespaceGets information about a namespace
get_operationGets information about any operation that returns an operation ID in the response, such as a CreateService request
get_serviceGets the settings for a specified service
list_instancesLists summary information about the instances that you registered by using a specified service
list_namespacesLists summary information about the namespaces that were created by the current AWS account
list_operationsLists operations that match the criteria that you specify
list_servicesLists summary information for all the services that are associated with one or more specified namespaces
list_tags_for_resourceLists tags for the specified resource
register_instanceCreates or updates one or more records and, optionally, creates a health check based on the settings in a specified service
tag_resourceAdds one or more tags to the specified resource
untag_resourceRemoves one or more tags from the specified resource
update_instance_custom_health_statusSubmits a request to change the health status of a custom health check to healthy or unhealthy
update_serviceSubmits a request to perform the following operations:

Examples

Run this code
if (FALSE) {
svc <- servicediscovery()
# This example creates an HTTP namespace.
svc$create_http_namespace(
  CreatorRequestId = "example-creator-request-id-0001",
  Description = "Example.com AWS Cloud Map HTTP Namespace",
  Name = "example-http.com"
)
}

Run the code above in your browser using DataLab