AWS 083: Gateway VPC endpoints
The real problem
A team recognizes the name Gateway VPC endpoints but has not connected the feature to a real requirement, identity boundary, network or data path, failure mode, price dimension, and cleanup owner. A plausible configuration could still fail the workload.
Final outcome
The learner will produce a requirement-led artifact for Gateway VPC endpoints, inspect the matching AWS control plane in the Management Console, run a matching CloudShell or AWS CLI query, interpret the output, diagnose one failure, defend one architecture choice, and prove cleanup or approved retained state.
The practical outcome is not a command transcript. It must show what was expected, what happened, what the result proves, what it does not prove, and which evidence would change the decision.
Learning objectives
By the end of this lesson, the learner can:
- explain a gateway endpoint is a route-table target;
- explain only s3 and dynamodb use this endpoint type;
- explain routes use aws-managed prefix lists;
- explain endpoint policies limit use of the path;
- explain service resource policies can require the endpoint;
- connect control-plane state to the real data, network, identity, or application behavior;
- identify cost and cleanup ownership before any optional mutation;
- troubleshoot from evidence without opening broad access or adding broad permissions.
Relationship model
Requirement
|
v
Identity and policy -> AWS configuration -> network or data path -> workload behavior
| | | |
+--------------------+----------------------+--------------------+
|
v
monitoring, cost, recovery, cleanup
Use this model to separate an AWS object that exists from a result that actually works. Every arrow is a verification boundary.
Prerequisites, permissions, Region, and safety
- Learning baseline: This sequence assumes practical Linux knowledge but no prior cloud-computing or AWS knowledge. Cloud, networking, security, data, automation, and architecture concepts must come from completed earlier lessons. If a prerequisite checkpoint is incomplete, return to its linked lesson before continuing.
- Confirm a non-root caller with
aws sts get-caller-identityand keep the account number private. - Use
ap-south-1unless this lesson explicitly names a second Region. - Confirm the intended profile and Region with
aws configure listbefore interpreting an empty result. - Use read-only List, Get, and Describe permissions for the named services. Design exercises run locally and require no resource-creation permission.
- This is a no-create lesson. Console and CLI work is read-only, and every design artifact is created locally.
- Never publish account IDs, public addresses, ARNs containing private account data, session IDs, presigned URLs, object data, credentials, or KMS material.
- Do not use root, world-open SSH or RDP, disabled TLS verification, unowned resources, or irreversible retention controls in a training exercise.
Core model
| Concept | What the learner must understand |
|---|---|
| A gateway endpoint is a route-table target | It provides private routing to supported Amazon S3 or DynamoDB regional service endpoints without an internet gateway or NAT device. It does not create endpoint ENIs. |
| Only S3 and DynamoDB use this endpoint type | Other AWS services normally require interface endpoints or another supported connection. Gateway endpoints are not powered by AWS PrivateLink. |
| Routes use AWS-managed prefix lists | Associating route tables adds service prefix-list routes whose target is the endpoint. These routes are more specific than the default internet or NAT route. |
| Endpoint policies limit use of the path | The policy controls which principals can use the endpoint to access which service resources. It does not grant identity permission by itself. |
| Service resource policies can require the endpoint | S3 bucket policies can use conditions such as aws:SourceVpce or aws:SourceVpc, but a mistaken deny can lock out console and other paths. |
| Gateway endpoints are regional | The endpoint routes traffic to S3 or DynamoDB in the same Region. Cross-Region service access follows a different path. |
How it works
A complete private-service control can combine workload identity policy, endpoint policy, route-table association, and S3 bucket or DynamoDB authorization. Each layer answers a different question. Gateway endpoints have no hourly or data-processing charge, but normal service and data-transfer pricing rules still apply.
Read the result in layers:
- Scope: account, Region, VPC, bucket, AZ, endpoint, principal, object version, or resource ARN.
- Control plane: the requested configuration exists and reached an expected state.
- Behavior: the request, connection, health check, replication, restore, or application result meets the requirement.
- Operations: monitoring, failure owner, cost, retention, rollback, and cleanup are known.
Control-plane success is necessary but not sufficient. A resource can be available while policy, routing, DNS, health, data, or application behavior remains wrong.
Architecture decision table
| Requirement | Preferred direction | Why |
|---|---|---|
| Private subnets send high-volume same-Region S3 traffic | S3 gateway endpoint | It avoids NAT dependency and interface-endpoint hourly processing design. |
| On-premises client needs private S3 DNS path through VPC | Evaluate S3 interface endpoint and Resolver design | Gateway endpoints are route-table targets for VPC traffic and are not directly extended through every hybrid path. |
| Bucket must accept requests only through one endpoint | Bucket policy condition on source endpoint | The resource enforces the expected network path, with a controlled administration exception. |
| Endpoint must permit only one bucket | Restrictive endpoint policy plus IAM and bucket policy | Endpoint policy limits the path but does not replace service authorization. |
Professional questions normally contain several valid services. State the requirement that selects one option, why the nearest alternative fails it, and what changed requirement would reverse the choice.
AWS Management Console guided practice
Before opening a service page, write the expected account, Region, starting state, and evidence. Do not choose Create, Save, Purchase, Lock, or Delete unless the lesson explicitly authorizes the live track.
- Open VPC Endpoints and select or create a test endpoint for the com.amazonaws.REGION.s3 or dynamodb service with type Gateway.
- Choose the workload route tables and inspect the endpoint policy before saving.
- Open those route tables and confirm the AWS-managed service prefix-list route now targets the gateway endpoint.
For each step, capture the field name and value in text. A screenshot may support the record but does not replace the explanation. Console labels can evolve, so use the service search and current documentation if a navigation label differs.
CloudShell and AWS CLI practice
CloudShell is the default browser-based command environment taught in AWS 028. AWS 029 and AWS 030 cover local CLI installation and authentication. This lesson therefore does not assume that an unconfigured local shell is ready.
Start every session with:
export AWS_DEFAULT_REGION="ap-south-1"
aws sts get-caller-identity --query Arn --output text
aws configure list
Redact the account portion of the ARN before sharing. Then perform the topic query:
Confirm the endpoint service, policy, route-table associations, and state.
aws ec2 describe-vpc-endpoints --vpc-endpoint-ids vpce-0123456789abcdef0 --query 'VpcEndpoints[0].{Type:VpcEndpointType,Service:ServiceName,State:State,Routes:RouteTableIds,Policy:PolicyDocument}'
Expected interpretation:
Type Gateway and a service name ending in s3 or dynamodb identify this design. Check every workload subnet route table is associated.
Replace every replace-with-... sample value before running its command, and use only an explicitly owned resource. Explain each option first. These queries are read-only; a successful response does not authorize a later create or delete operation.
Practical work
Create p05-gateway-endpoint-plan.md for an S3 gateway endpoint in nw-p05-vpc. Select the two private route tables, show the AWS-managed prefix-list route, write an endpoint policy limited to the future P06 bucket pattern, trace S3 traffic that bypasses NAT, and name the identity, bucket, KMS, and endpoint policy layers that still apply. Do not create an endpoint.
The evidence package must contain:
- the problem and final requirement in the learner's own words;
- caller type and Region with private identifiers redacted;
- exact planned values, ownership, and cost class;
- one Console observation and matching CLI or API evidence;
- one behavior result or supplied data-plane record;
- one denied, failed, or counterexample result and evidence-led diagnosis;
- one architecture choice plus the rejected alternative;
- cleanup proof or explicit retained-state owner, expiry, and next lesson.
Verification standard
Use expected state before observed state. Record timestamps in UTC and preserve the original failure before changing anything. A passing submission answers all four questions:
- What exact requirement was tested?
- Which evidence proves the AWS configuration?
- Which evidence proves the workload behavior?
- What remains unproven or requires later monitoring?
If AWS returns no rows, verify account, Region, permission, filters, pagination, resource type, and deletion state before concluding that nothing exists.
Common failures and troubleshooting
| Symptom | Evidence first | Likely boundary | Smallest safe response |
|---|---|---|---|
| object appears missing | caller, Region, filters, pagination, tags | scope or read permission | align scope before creating a duplicate |
| state remains pending or unavailable | service state, events, dependencies, quotas | dependency or capacity | correct the named dependency and wait with a bound |
| AccessDenied | principal, action, resource, explicit-deny context | identity, resource, endpoint, organization, or KMS policy | change only the proven policy layer |
| configuration exists but behavior fails | route, DNS, security, listener, health, logs, object version | data path or application | test the next boundary and change one control |
| bill is higher than expected | hours, bytes, requests, AZs, addresses, retention | cost model or retained resource | stop optional work and reconcile the ledger |
| cleanup is blocked | dependency inventory and owning service | deletion order or immutable state | remove owned dependants in reviewed reverse order |
Do not troubleshoot by attaching administrator access, opening administration ports to the internet, disabling encryption, retrying uncontrolled creation, deleting unknown resources, or weakening retention.
Cost, cleanup, and retained state
No AWS resource is created. Close CloudShell and remove or redact downloaded evidence.
Cleanup evidence requires terminal state and an after-inventory. Search related ENIs, public IPv4 addresses, EBS volumes and snapshots, load balancers, target groups, Auto Scaling instances, endpoints, logs, S3 versions and delete markers, backup recovery points, and global IAM roles when they apply. Billing data can lag, so schedule a later review.
Architecture and certification decisions
- Certification coverage: SAA-C03; SOA-C03; SAP-C02; DOP-C02.
- Exam mapping: SAA D1-D3.
- Explain service scope, failure boundary, consistency, recovery, security, operations, and price rather than matching a keyword.
- Treat availability and durability, encryption and authorization, routing and filtering, health and lifecycle, backup and replication, and discount and capacity as separate concepts.
- Do not reproduce protected certification questions.
Knowledge check
- Does a gateway endpoint create a private IP in each subnet?
Expected direction: No. It adds prefix-list routes to selected route tables.
- Which services support gateway endpoints?
Expected direction: Amazon S3 and DynamoDB.
- Does an endpoint policy grant an IAM principal access?
Expected direction: No. It limits endpoint use; the principal still needs service permission and the resource policy must allow the request.
- Why might cross-Region S3 traffic still use NAT?
Expected direction: The gateway endpoint route is for the regional service prefix list, not every S3 destination worldwide.
Completion gate and assessment
| Area | Points | Passing evidence |
|---|---|---|
| Requirement and model | 15 | Correct scope, terminology, and final outcome |
| Console evidence | 15 | Current path and interpreted fields |
| CLI or API evidence | 15 | Scoped command, expected result, and limitations |
| Behavior or decision exercise | 20 | Reproducible result or defensible architecture reasoning |
| Troubleshooting | 15 | Original symptom, hypothesis, one change, retest, rollback |
| Security and cost | 10 | Least privilege, data protection, current price dimensions |
| Cleanup and handoff | 10 | Terminal-state proof or approved retained-state record |
Pass at 80 out of 100 with no critical safety failure. A missing practical artifact, unexplained output, unsafe access, destructive action outside the owned scope, unplanned billed resource, or false cleanup claim requires remediation and a changed retest.