Amazon Web Services, Inc.

AWS App Mesh

App Mesh is a service mesh based on the Envoy proxy that makes it easy to monitor and control microservices. App Mesh standardizes how your microservices…

Developer tools#openapi#cloud

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

App Mesh is a service mesh based on the Envoy proxy that makes it easy to
monitor and control microservices. App Mesh standardizes how your microservices
communicate, giving you end-to-end visibility and helping to ensure high availability for
your applications.
App Mesh gives you consistent visibility and network traffic controls for
every microservice in an application. You can use App Mesh with Amazon Web Services Fargate, Amazon ECS, Amazon EKS, Kubernetes on Amazon Web Services, and
Amazon EC2.

App Mesh supports microservice applications that use service discovery
naming for their components. For more information about service discovery on Amazon ECS, see Service
Discovery in the Amazon Elastic Container Service Developer Guide . Kubernetes
kube-dns and coredns are supported. For more information,
see DNS
for Services and Pods in the Kubernetes documentation.

Endpoints 38

Gateway route

  • GETList gateway routes/v20190125/meshes/:meshName/virtualGateway/:virtualGatewayName/gatewayRoutes?nextToken=string&limit=0&meshOwner=stringReturns a list of existing gateway routes that are associated to a virtual gateway.
  • PUTCreate gateway route/v20190125/meshes/:meshName/virtualGateway/:virtualGatewayName/gatewayRoutes?meshOwner=stringCreates a gateway route. A gateway route is attached to a virtual gateway and routes traffic to an existing virtual service. If a route matches a request, it…
  • GETDescribe gateway route/v20190125/meshes/:meshName/virtualGateway/:virtualGatewayName/gatewayRoutes/:gatewayRouteName?meshOwner=stringDescribes an existing gateway route.
  • PUTUpdate gateway route/v20190125/meshes/:meshName/virtualGateway/:virtualGatewayName/gatewayRoutes/:gatewayRouteName?meshOwner=stringUpdates an existing gateway route that is associated to a specified virtual gateway in a service mesh.
  • DELETEDelete gateway route/v20190125/meshes/:meshName/virtualGateway/:virtualGatewayName/gatewayRoutes/:gatewayRouteName?meshOwner=stringDeletes an existing gateway route.

Mesh

  • GETList meshes/v20190125/meshes?nextToken=string&limit=0Returns a list of existing service meshes.
  • PUTCreate mesh/v20190125/meshesCreates a service mesh. A service mesh is a logical boundary for network traffic between services that are represented by resources within the mesh. After you…
  • GETDescribe mesh/v20190125/meshes/:meshName?meshOwner=stringDescribes an existing service mesh.
  • PUTUpdate mesh/v20190125/meshes/:meshNameUpdates an existing service mesh.
  • DELETEDelete mesh/v20190125/meshes/:meshNameDeletes an existing service mesh. You must delete all resources (virtual services, routes, virtual routers, and virtual nodes) in the service mesh before you…

Route

  • GETList routes/v20190125/meshes/:meshName/virtualRouter/:virtualRouterName/routes?nextToken=string&limit=0&meshOwner=stringReturns a list of existing routes in a service mesh.
  • PUTCreate route/v20190125/meshes/:meshName/virtualRouter/:virtualRouterName/routes?meshOwner=stringCreates a route that is associated with a virtual router. You can route several different protocols and define a retry policy for a route. Traffic can be…
  • GETDescribe route/v20190125/meshes/:meshName/virtualRouter/:virtualRouterName/routes/:routeName?meshOwner=stringDescribes an existing route.
  • PUTUpdate route/v20190125/meshes/:meshName/virtualRouter/:virtualRouterName/routes/:routeName?meshOwner=stringUpdates an existing route for a specified service mesh and virtual router.
  • DELETEDelete route/v20190125/meshes/:meshName/virtualRouter/:virtualRouterName/routes/:routeName?meshOwner=stringDeletes an existing route.

Virtual gateway

  • GETList virtual gateways/v20190125/meshes/:meshName/virtualGateways?nextToken=string&limit=0&meshOwner=stringReturns a list of existing virtual gateways in a service mesh.
  • PUTCreate virtual gateway/v20190125/meshes/:meshName/virtualGateways?meshOwner=stringCreates a virtual gateway. A virtual gateway allows resources outside your mesh to communicate to resources that are inside your mesh. The virtual gateway…
  • GETDescribe virtual gateway/v20190125/meshes/:meshName/virtualGateways/:virtualGatewayName?meshOwner=stringDescribes an existing virtual gateway.
  • PUTUpdate virtual gateway/v20190125/meshes/:meshName/virtualGateways/:virtualGatewayName?meshOwner=stringUpdates an existing virtual gateway in a specified service mesh.
  • DELETEDelete virtual gateway/v20190125/meshes/:meshName/virtualGateways/:virtualGatewayName?meshOwner=stringDeletes an existing virtual gateway. You cannot delete a virtual gateway if any gateway routes are associated to it.

Virtual node

  • GETList virtual nodes/v20190125/meshes/:meshName/virtualNodes?nextToken=string&limit=0&meshOwner=stringReturns a list of existing virtual nodes.
  • PUTCreate virtual node/v20190125/meshes/:meshName/virtualNodes?meshOwner=stringCreates a virtual node within a service mesh. A virtual node acts as a logical pointer to a particular task group, such as an Amazon ECS service or a…
  • GETDescribe virtual node/v20190125/meshes/:meshName/virtualNodes/:virtualNodeName?meshOwner=stringDescribes an existing virtual node.
  • PUTUpdate virtual node/v20190125/meshes/:meshName/virtualNodes/:virtualNodeName?meshOwner=stringUpdates an existing virtual node in a specified service mesh.
  • DELETEDelete virtual node/v20190125/meshes/:meshName/virtualNodes/:virtualNodeName?meshOwner=stringDeletes an existing virtual node. You must delete any virtual services that list a virtual node as a service provider before you can delete the virtual node…

Virtual router

  • GETList virtual routers/v20190125/meshes/:meshName/virtualRouters?nextToken=string&limit=0&meshOwner=stringReturns a list of existing virtual routers in a service mesh.
  • PUTCreate virtual router/v20190125/meshes/:meshName/virtualRouters?meshOwner=stringCreates a virtual router within a service mesh. Specify a listener for any inbound traffic that your virtual router receives. Create a virtual router for each…
  • GETDescribe virtual router/v20190125/meshes/:meshName/virtualRouters/:virtualRouterName?meshOwner=stringDescribes an existing virtual router.
  • PUTUpdate virtual router/v20190125/meshes/:meshName/virtualRouters/:virtualRouterName?meshOwner=stringUpdates an existing virtual router in a specified service mesh.
  • DELETEDelete virtual router/v20190125/meshes/:meshName/virtualRouters/:virtualRouterName?meshOwner=stringDeletes an existing virtual router. You must delete any routes associated with the virtual router before you can delete the router itself.

Virtual service

  • GETList virtual services/v20190125/meshes/:meshName/virtualServices?nextToken=string&limit=0&meshOwner=stringReturns a list of existing virtual services in a service mesh.
  • PUTCreate virtual service/v20190125/meshes/:meshName/virtualServices?meshOwner=stringCreates a virtual service within a service mesh. A virtual service is an abstraction of a real service that is provided by a virtual node directly or…
  • GETDescribe virtual service/v20190125/meshes/:meshName/virtualServices/:virtualServiceName?meshOwner=stringDescribes an existing virtual service.
  • PUTUpdate virtual service/v20190125/meshes/:meshName/virtualServices/:virtualServiceName?meshOwner=stringUpdates an existing virtual service in a specified service mesh.
  • DELETEDelete virtual service/v20190125/meshes/:meshName/virtualServices/:virtualServiceName?meshOwner=stringDeletes an existing virtual service.
  • GETList tags for resource/v20190125/tags?resourceArn=string&nextToken=string&limit=0List the tags for an App Mesh resource.
  • PUTTag resource/v20190125/tag?resourceArn=stringAssociates the specified tags to a resource with the specified resourceArn . If existing tags on a resource aren't specified in the request parameters, they…
  • PUTUntag resource/v20190125/untag?resourceArn=stringDeletes specified tags from a resource.

API details

Base URL
https://appmesh.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
38 operations on 17 pathsPUT 16GET 15DELETE 7
Main resources
Gateway route 5Mesh 5Route 5Virtual gateway 5Virtual node 5Virtual router 5Virtual service 5
Description format
AWS Smithy model, API version 2019-01-25

How to test the AWS App Mesh in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the AWS App Mesh collection, without the publisher's secrets.
  3. Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List gateway routes” (GET /v20190125/meshes/:meshName/virtualGateway/:virtualGatewayName/gatewayRoutes?nextToken=string&limit=0&meshOwner=string), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the AWS App Mesh?

App Mesh is a service mesh based on the Envoy proxy that makes it easy to monitor and control microservices. App Mesh standardizes how your microservices… It is listed under Developer tools and has 38 endpoints.

Who publishes the AWS App Mesh?

It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.

What is the base URL of the AWS App Mesh?

Requests go to https://appmesh.{region}.amazonaws.com. Endpoint paths are added to this base URL.

How do I authenticate with the AWS App Mesh?

With AWS Signature Version 4 (requests signed with your AWS access key).

How many endpoints does the AWS App Mesh have?

38 operations on 17 paths (16 PUT, 15 GET, 7 DELETE). The largest groups are Gateway route, Mesh, Route, Virtual gateway.

Is forking the AWS App Mesh free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.