Na}{

File Content: `create-virtual-node.rst`

**Example 1: To create a new virtual node that uses DNS for discovery**

The following ``create-virtual-node`` example uses a JSON input file to create a virtual node that uses DNS for service discovery. ::

    aws appmesh create-virtual-node \
        --cli-input-json file://create-virtual-node-dns.json

Contents of ``create-virtual-node-dns.json``::

    {
        "meshName": "app1",
        "spec": {
            "listeners": [
                {
                    "portMapping": {
                        "port": 80,
                        "protocol": "http"
                    }
                }
            ],
            "serviceDiscovery": {
                "dns": {
                    "hostname": "serviceBv1.svc.cluster.local"
                }
            }
        },
        "virtualNodeName": "vnServiceBv1"
    }

Output::

    {
        "virtualNode": {
            "meshName": "app1",
            "metadata": {
                "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceBv1",
                "createdAt": 1563810019.874,
                "lastUpdatedAt": 1563810019.874,
                "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
                "version": 1
            },
            "spec": {
                "listeners": [
                    {
                        "portMapping": {
                            "port": 80,
                            "protocol": "http"
                        }
                    }
                ],
                "serviceDiscovery": {
                    "dns": {
                        "hostname": "serviceBv1.svc.cluster.local"
                    }
                }
            },
            "status": {
                "status": "ACTIVE"
            },
            "virtualNodeName": "vnServiceBv1"
        }
    }

**Example 2: To create a new virtual node that uses AWS Cloud Map for discovery**

The following ``create-virtual-node`` example uses a JSON input file to create a virtual node that uses AWS Cloud Map for service discovery. ::

    aws appmesh create-virtual-node \
        --cli-input-json file://create-virtual-node-cloud-map.json

Contents of ``create-virtual-node-cloud-map.json``::

    {
        "meshName": "app1",
        "spec": {
            "backends": [
                {
                    "virtualService": {
                        "virtualServiceName": "serviceA.svc.cluster.local"
                    }
                }
            ],
            "listeners": [
                {
                    "portMapping": {
                        "port": 80,
                        "protocol": "http"
                    }
                }
            ],
            "serviceDiscovery": {
                "awsCloudMap": {
                    "attributes": [
                        {
                            "key": "Environment",
                            "value": "Testing"
                        }
                    ],
                    "namespaceName": "namespace1",
                    "serviceName": "serviceA"
                }
            }
        },
        "virtualNodeName": "vnServiceA"
    }

Output::

    {
        "virtualNode": {
            "meshName": "app1",
            "metadata": {
                "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualNode/vnServiceA",
                "createdAt": 1563810859.465,
                "lastUpdatedAt": 1563810859.465,
                "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
                "version": 1
            },
            "spec": {
                "backends": [
                    {
                        "virtualService": {
                            "virtualServiceName": "serviceA.svc.cluster.local"
                        }
                    }
                ],
                "listeners": [
                    {
                        "portMapping": {
                            "port": 80,
                            "protocol": "http"
                        }
                    }
                ],
                "serviceDiscovery": {
                    "awsCloudMap": {
                        "attributes": [
                            {
                                "key": "Environment",
                                "value": "Testing"
                            }
                        ],
                        "namespaceName": "namespace1",
                        "serviceName": "serviceA"
                    }
                }
            },
            "status": {
                "status": "ACTIVE"
            },
            "virtualNodeName": "vnServiceA"
        }
    }

For more information, see `Virtual Nodes <https://docs.aws.amazon.com/app-mesh/latest/userguide/virtual_nodes.html>`__ in the *AWS App Mesh User Guide*.

Name	Size	Permission
create-mesh.rst	1598 bytes	0644
create-route.rst	10824 bytes	0644
create-virtual-node.rst	4986 bytes	0644
create-virtual-router.rst	1629 bytes	0644
create-virtual-service.rst	3155 bytes	0644
delete-mesh.rst	907 bytes	0644
delete-route.rst	1629 bytes	0644
delete-virtual-node.rst	1405 bytes	0644
delete-virtual-router.rst	1211 bytes	0644
delete-virtual-service.rst	1009 bytes	0644
describe-mesh.rst	821 bytes	0644
describe-route.rst	1648 bytes	0644
describe-virtual-node.rst	1424 bytes	0644
describe-virtual-router.rst	1229 bytes	0644
describe-virtual-service.rst	1209 bytes	0644
list-meshes.rst	500 bytes	0644
list-routes.rst	698 bytes	0644
list-tags-for-resource.rst	589 bytes	0644
list-virtual-nodes.rst	842 bytes	0644
list-virtual-routers.rst	641 bytes	0644
list-virtual-services.rst	931 bytes	0644
tag-resource.rst	317 bytes	0644
untag-resource.rst	299 bytes	0644
update-mesh.rst	1207 bytes	0644
update-route.rst	2342 bytes	0644
update-virtual-node.rst	2717 bytes	0644
update-virtual-router.rst	1605 bytes	0644
update-virtual-service.rst	1533 bytes	0644

File Content: create-virtual-node.rst

File Content: `create-virtual-node.rst`