AWS gameliftservers documentation change

Service: gameliftservers · 2026-05-01 · Documentation low

File: gameliftservers/latest/developerguide/containers-remote-access.md

Summary

Added new section 'View container port mappings' with detailed instructions on how to view port mappings between container ports and instance connection ports via console, AWS CLI, and SDK, including example commands and responses.

Security assessment

This change adds documentation for a troubleshooting and monitoring feature that helps users understand network port mappings. While understanding port mappings can be important for security configuration and auditing, the documentation itself does not address a specific security vulnerability, weakness, or incident. It's a general feature documentation update without explicit security context.

Diff

diff --git a/gameliftservers/latest/developerguide/containers-remote-access.md b/gameliftservers/latest/developerguide/containers-remote-access.md
index 1c1ce9596..f1f7e608b 100644
--- a//gameliftservers/latest/developerguide/containers-remote-access.md
+++ b//gameliftservers/latest/developerguide/containers-remote-access.md
@@ -7 +7 @@
-Connect to a containerConnect to a container through the consoleConnect to container hosting a game session
+Connect to a containerConnect to a container through the consoleConnect to container hosting a game sessionView container port mappings
@@ -158,0 +159,95 @@ Note the `GameServerContainerDefinition.ContainerName` value (for example, `game
+## View container port mappings
+
+Port mappings show how container ports map to connection ports on your fleet instances. Each container port that accepts inbound traffic is assigned a connection port on the instance. You can check port mappings to discover which connection ports map to your container ports or to troubleshoot connection issues. You can view port mappings in the Amazon GameLift Servers console, or use the AWS CLI or AWS SDK.
+
+### View port mappings in the console
+
+In the Amazon GameLift Servers console, choose **Managed containers** from the navigation pane, and then **Fleets**. Choose a fleet to open the fleet details page. You can view port mappings in the following locations:
+
+  * **Instance details page** – Shows port mappings for the per-instance container group on the selected instance.
+
+  * **Compute details page** – Shows port mappings for the game server container group on the selected compute.
+
+
+
+
+Both pages include a search field to filter port mappings by container name.
+
+### View port mappings with the AWS CLI
+
+Use the `describe-container-group-port-mappings` command to retrieve port mappings for a container group on a fleet instance. Specify the container group type and either a `--compute-name` (for game server groups) or an `--instance-id` (for per-instance groups). Optionally, include the `--container-name` parameter to filter results to a specific container.
+
+**Example: Game server container group**
+
+The following command retrieves port mappings for the game server container group on a specific compute.
+    
+    
+    aws gamelift describe-container-group-port-mappings \
+        --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
+        --container-group-type GAME_SERVER \
+        --compute-name 62c5ff7f7a9a445d84877074c80aeafc
+
+If successful, Amazon GameLift Servers returns a response like the following:
+    
+    
+    {
+      "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
+      "Location": "us-west-2",
+      "ContainerGroupDefinitionArn": "arn:aws:gamelift:us-west-2:123456789012:containergroupdefinition/MyGameServerGroup",
+      "ContainerGroupType": "GAME_SERVER",
+      "ComputeName": "62c5ff7f7a9a445d84877074c80aeafc",
+      "InstanceId": "i-1234567890abcdef0",
+      "ContainerGroupPortMappings": [
+        {
+          "ContainerName": "MyGameServer",
+          "ContainerRuntimeId": "a1b2c3d4e5f6",
+          "ContainerPortMappings": [
+            {
+              "ContainerPort": 7777,
+              "ConnectionPort": 1025,
+              "Protocol": "UDP"
+            },
+            {
+              "ContainerPort": 8080,
+              "ConnectionPort": 1026,
+              "Protocol": "TCP"
+            }
+          ]
+        }
+      ]
+    }
+
+**Example: Per-instance container group**
+
+The following command retrieves port mappings for the per-instance container group on a specific instance.
+    
+    
+    aws gamelift describe-container-group-port-mappings \
+        --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
+        --container-group-type PER_INSTANCE \
+        --instance-id i-1234567890abcdef0
+
+If successful, Amazon GameLift Servers returns a response like the following:
+    
+    
+    {
+      "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
+      "Location": "us-west-2",
+      "ContainerGroupDefinitionArn": "arn:aws:gamelift:us-west-2:123456789012:containergroupdefinition/MyPerInstanceGroup",
+      "ContainerGroupType": "PER_INSTANCE",
+      "InstanceId": "i-1234567890abcdef0",
+      "ContainerGroupPortMappings": [
+        {
+          "ContainerName": "MySupportContainer",
+          "ContainerRuntimeId": "f6e5d4c3b2a1",
+          "ContainerPortMappings": [
+            {
+              "ContainerPort": 8443,
+              "ConnectionPort": 2025,
+              "Protocol": "TCP"
+            }
+          ]
+        }
+      ]
+    }
+