From a80fac9aee1efaac1d16f4005ccc93fed22c62c3 Mon Sep 17 00:00:00 2001 From: AWS SDK for Go v2 automation user Date: Tue, 14 Jan 2025 19:03:07 +0000 Subject: [PATCH] Update API model --- codegen/sdk-codegen/aws-models/gamelift.json | 94 +++++++++++++++++--- codegen/sdk-codegen/aws-models/route-53.json | 18 ++++ 2 files changed, 98 insertions(+), 14 deletions(-) diff --git a/codegen/sdk-codegen/aws-models/gamelift.json b/codegen/sdk-codegen/aws-models/gamelift.json index f50d60ad68b..e9f7ef65eec 100644 --- a/codegen/sdk-codegen/aws-models/gamelift.json +++ b/codegen/sdk-codegen/aws-models/gamelift.json @@ -990,7 +990,7 @@ } }, "FleetRoleArn": { - "target": "com.amazonaws.gamelift#ArnStringModel", + "target": "com.amazonaws.gamelift#IamRoleArn", "traits": { "smithy.api#documentation": "

The unique identifier for an Identity and Access Management (IAM) role with permissions to run your\n containers on resources that are managed by Amazon GameLift. See Set up an IAM service\n role. This fleet property can't be changed.

" } @@ -1948,7 +1948,7 @@ "type": "structure", "members": { "FleetRoleArn": { - "target": "com.amazonaws.gamelift#ArnStringModel", + "target": "com.amazonaws.gamelift#IamRoleArn", "traits": { "smithy.api#clientOptional": {}, "smithy.api#documentation": "

The unique identifier for an Identity and Access Management (IAM) role with permissions to run your\n containers on resources that are managed by Amazon GameLift. Use an IAM service role with the\n GameLiftContainerFleetPolicy managed policy attached. For more\n information, see Set up an IAM service\n role. You can't change this fleet property after the fleet is\n created.

\n

IAM role ARN values use the following pattern: arn:aws:iam::[Amazon Web Services account]:role/[role name].

", @@ -6021,7 +6021,7 @@ } ], "traits": { - "smithy.api#documentation": "

Retrieves information, including current status, about a game session placement\n request.

\n

To get game session placement details, specify the placement ID.

\n

This operation is not designed to be continually called to track game session status.\n This practice can cause you to exceed your API limit, which results in errors. Instead,\n you must configure configure an Amazon Simple Notification Service (SNS) topic to receive notifications from\n FlexMatch or queues. Continuously polling with DescribeGameSessionPlacement\n should only be used for games in development with low game session usage.

" + "smithy.api#documentation": "

Retrieves information, including current status, about a game session placement\n request.

\n

To get game session placement details, specify the placement ID.

\n

This operation is not designed to be continually called to track game session status.\n This practice can cause you to exceed your API limit, which results in errors. Instead,\n you must configure an Amazon Simple Notification Service (SNS) topic to receive notifications from FlexMatch or\n queues. Continuously polling with DescribeGameSessionPlacement should only\n be used for games in development with low game session usage.

" } }, "com.amazonaws.gamelift#DescribeGameSessionPlacementInput": { @@ -8555,7 +8555,7 @@ } }, "traits": { - "smithy.api#documentation": "

A list of fleet locations where a game session queue can place new game sessions. You\n can use a filter to temporarily turn off placements for specific locations. For queues\n that have multi-location fleets, you can use a filter configuration allow placement with\n some, but not all of these locations.

" + "smithy.api#documentation": "

A list of fleet locations where a game session queue can place new game sessions. You\n can use a filter to temporarily exclude specific locations from receiving placements.\n For queues that have multi-location fleets, you can use a filter configuration allow\n placement with some, but not all, of a fleet's locations.

" } }, "com.amazonaws.gamelift#FilterInstanceStatus": { @@ -11945,7 +11945,7 @@ "PlayerLatencies": { "target": "com.amazonaws.gamelift#PlayerLatencyList", "traits": { - "smithy.api#documentation": "

A set of values, expressed in milliseconds, that indicates the amount of latency that a player experiences when connected to @aws; Regions.

" + "smithy.api#documentation": "

A set of values, expressed in milliseconds, that indicates the amount of latency that a player experiences when connected to Amazon Web Services Regions.

" } }, "StartTime": { @@ -11995,10 +11995,16 @@ "traits": { "smithy.api#documentation": "

Information on the matchmaking process for this game. Data is in JSON syntax,\n formatted as a string. It identifies the matchmaking configuration used to create the\n match, and contains data on all players assigned to the match, including player\n attributes and team assignments. For more details on matchmaker data, see Match\n Data.

" } + }, + "PriorityConfigurationOverride": { + "target": "com.amazonaws.gamelift#PriorityConfigurationOverride", + "traits": { + "smithy.api#documentation": "

A prioritized list of locations to use with a game session placement request and\n instructions on how to use it. This list overrides a queue's prioritized location list\n for a single game session placement request only. The list can include Amazon Web Services Regions,\n local zones, and custom locations (for Anywhere fleets). The fallback strategy instructs\n Amazon GameLift to use the override list for the first placement attempt only or for all\n placement attempts.

" + } } }, "traits": { - "smithy.api#documentation": "

Represents a potential game session placement, including the full details of the\n original placement request and the current status.

\n \n

If the game session placement status is PENDING, the properties for game\n session ID/ARN, region, IP address/DNS, and port aren't final. A game session is not\n active and ready to accept players until placement status reaches\n FULFILLED. When the placement is in PENDING status,\n Amazon GameLift may attempt to place a game session multiple times before succeeding. With\n each attempt it creates a https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession object and updates this\n placement object with the new game session properties..

\n " + "smithy.api#documentation": "

Represents a potential game session placement, including the full details of the\n original placement request and the current status.

\n \n

If the game session placement status is PENDING, the properties for game\n session ID/ARN, region, IP address/DNS, and port aren't final. A game session is not\n active and ready to accept players until placement status reaches\n FULFILLED. When the placement is in PENDING status,\n Amazon GameLift may attempt to place a game session multiple times before succeeding. With\n each attempt it creates a https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession object and updates this\n placement object with the new game session properties.

\n " } }, "com.amazonaws.gamelift#GameSessionPlacementState": { @@ -14248,6 +14254,18 @@ "target": "com.amazonaws.gamelift#LocationModel" } }, + "com.amazonaws.gamelift#LocationOrderOverrideList": { + "type": "list", + "member": { + "target": "com.amazonaws.gamelift#LocationStringModel" + }, + "traits": { + "smithy.api#length": { + "min": 1, + "max": 10 + } + } + }, "com.amazonaws.gamelift#LocationState": { "type": "structure", "members": { @@ -15073,6 +15091,23 @@ "target": "com.amazonaws.gamelift#PlacedPlayerSession" } }, + "com.amazonaws.gamelift#PlacementFallbackStrategy": { + "type": "enum", + "members": { + "DEFAULT_AFTER_SINGLE_PASS": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "DEFAULT_AFTER_SINGLE_PASS" + } + }, + "NONE": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "NONE" + } + } + } + }, "com.amazonaws.gamelift#Player": { "type": "structure", "members": { @@ -15097,7 +15132,7 @@ "LatencyInMs": { "target": "com.amazonaws.gamelift#LatencyMap", "traits": { - "smithy.api#documentation": "

A set of values, expressed in milliseconds, that indicates the amount of latency that a player experiences when connected to @aws; Regions. If this property is present, FlexMatch considers placing the match only in\n Regions for which latency is reported.

\n

If a matchmaker has a rule that evaluates player latency, players must report latency\n in order to be matched. If no latency is reported in this scenario, FlexMatch assumes that\n no Regions are available to the player and the ticket is not matchable.

" + "smithy.api#documentation": "

A set of values, expressed in milliseconds, that indicates the amount of latency that a player experiences when connected to Amazon Web Services Regions. If this property is present, FlexMatch considers placing the match only in\n Regions for which latency is reported.

\n

If a matchmaker has a rule that evaluates player latency, players must report latency\n in order to be matched. If no latency is reported in this scenario, FlexMatch assumes that\n no Regions are available to the player and the ticket is not matchable.

" } } }, @@ -15439,18 +15474,40 @@ "PriorityOrder": { "target": "com.amazonaws.gamelift#PriorityTypeList", "traits": { - "smithy.api#documentation": "

The recommended sequence to use when prioritizing where to place new game sessions.\n Each type can only be listed once.

\n " + "smithy.api#documentation": "

A custom sequence to use when prioritizing where to place new game sessions. Each\n priority type is listed once.

\n " } }, "LocationOrder": { "target": "com.amazonaws.gamelift#LocationList", "traits": { - "smithy.api#documentation": "

The prioritization order to use for fleet locations, when the\n PriorityOrder property includes LOCATION. Locations are\n identified by Amazon Web Services Region codes such as us-west-2. Each location can only\n be listed once.

" + "smithy.api#documentation": "

The prioritization order to use for fleet locations, when the\n PriorityOrder property includes LOCATION. Locations can\n include Amazon Web Services Region codes (such as us-west-2), local zones, and custom\n locations (for Anywhere fleets). Each location must be listed only once. For details, see \n Amazon GameLift service locations.\n

" + } + } + }, + "traits": { + "smithy.api#documentation": "

Custom prioritization settings for a game session queue to use when searching for\n available game servers to place new game sessions. This configuration replaces the\n default FleetIQ prioritization process.

\n

By default, a queue makes placements based on the following default\n prioritizations:

\n " + } + }, + "com.amazonaws.gamelift#PriorityConfigurationOverride": { + "type": "structure", + "members": { + "PlacementFallbackStrategy": { + "target": "com.amazonaws.gamelift#PlacementFallbackStrategy", + "traits": { + "smithy.api#documentation": "

Instructions for how to use the override list if the first round of placement attempts fails. The first round is a failure if \n Amazon GameLift searches all listed locations, in all of the queue's destinations, without finding an available hosting resource\n for a new game session. Valid strategies include:

\n " + } + }, + "LocationOrder": { + "target": "com.amazonaws.gamelift#LocationOrderOverrideList", + "traits": { + "smithy.api#clientOptional": {}, + "smithy.api#documentation": "

A prioritized list of hosting locations. The list can include Amazon Web Services Regions (such as\n us-west-2), local zones, and custom locations (for Anywhere fleets).\n Each location must be listed only once. For details, see \n Amazon GameLift service locations.\n

", + "smithy.api#required": {} } } }, "traits": { - "smithy.api#documentation": "

Custom prioritization settings for use by a game session queue when placing new game\n sessions with available game servers. When defined, this configuration replaces the\n default FleetIQ prioritization process, which is as follows:

\n \n

Changing the priority order will affect how game sessions are placed.

" + "smithy.api#documentation": "

An alternate list of prioritized locations for use with a game session queue. When\n this property is included in a StartGameSessionPlacement request, this list overrides the queue's default\n location prioritization, as defined in the queue's PriorityConfiguration setting (LocationOrder). This\n property overrides the queue's default priority list for individual placement requests\n only. Use this property only with queues that have a PriorityConfiguration\n setting that prioritizes first.

\n \n

A priority configuration override list does not override a queue's\n FilterConfiguration setting, if the queue has one. Filter configurations are used to\n limit placements to a subset of the locations in a queue's destinations. If the\n override list includes a location that's not included in the FilterConfiguration\n allowed list, Amazon GameLift won't attempt to place a game session there.

\n " } }, "com.amazonaws.gamelift#PriorityType": { @@ -16709,10 +16766,13 @@ }, { "target": "com.amazonaws.gamelift#UnauthorizedException" + }, + { + "target": "com.amazonaws.gamelift#UnsupportedRegionException" } ], "traits": { - "smithy.api#documentation": "

Places a request for a new game session in a queue. When processing a placement\n request, Amazon GameLift searches for available resources on the queue's destinations, scanning\n each until it finds resources or the placement request times out.

\n

A game session placement request can also request player sessions. When a new game\n session is successfully created, Amazon GameLift creates a player session for each player\n included in the request.

\n

When placing a game session, by default Amazon GameLift tries each fleet in the order they are\n listed in the queue configuration. Ideally, a queue's destinations are listed in\n preference order.

\n

Alternatively, when requesting a game session with players, you can also provide\n latency data for each player in relevant Regions. Latency data indicates the performance\n lag a player experiences when connected to a fleet in the Region. Amazon GameLift uses latency\n data to reorder the list of destinations to place the game session in a Region with\n minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each\n Region's average lag for all players and reorders to get the best game play across all\n players.

\n

To place a new game session request, specify the following:

\n \n

If successful, a new game session placement is created.

\n

To track the status of a placement request, call DescribeGameSessionPlacement and check the request's status. If the status\n is FULFILLED, a new game session has been created and a game session ARN\n and Region are referenced. If the placement request times out, you can resubmit the\n request or retry it with a different queue.

" + "smithy.api#documentation": "

Makes a request to start a new game session using a game session queue. When\n processing a placement request in a queue, Amazon GameLift finds the best possible available\n resource to host the game session and prompts the resource to start the game session.

\n

\n Request options\n

\n

Call this API with the following minimum parameters:\n GameSessionQueueName,\n MaximumPlayerSessionCount, and\n PlacementID. You can also include game session data (data formatted\n as strings) or game properties (data formatted as key-value pairs) to pass to the new\n game session.

\n \n

\n Result\n

\n

If successful, this request generates a new game session placement request and adds it\n to the game session queue for Amazon GameLift to process in turn. You can track the status of\n individual placement requests by calling DescribeGameSessionPlacement. A new game session is running if the status\n is FULFILLED and the request returns the game session connection\n information (IP address and port). If you include player session data, Amazon GameLift creates a\n player session for each player ID in the request.

\n

The request results in a BadRequestException in the following\n situations:

\n \n

Amazon GameLift continues to retry each placement request until it reaches the queue's timeout\n setting. If a request times out, you can resubmit the request to the same queue or try a\n different queue.

" } }, "com.amazonaws.gamelift#StartGameSessionPlacementInput": { @@ -16757,7 +16817,7 @@ "PlayerLatencies": { "target": "com.amazonaws.gamelift#PlayerLatencyList", "traits": { - "smithy.api#documentation": "

A set of values, expressed in milliseconds, that indicates the amount of latency that a player experiences when connected to @aws; Regions. This information is used to try to place the new game session where it\n can offer the best possible gameplay experience for the players.

" + "smithy.api#documentation": "

A set of values, expressed in milliseconds, that indicates the amount of latency that a player experiences when connected to Amazon Web Services Regions. This information is used to try to place the new game session where it\n can offer the best possible gameplay experience for the players.

" } }, "DesiredPlayerSessions": { @@ -16771,6 +16831,12 @@ "traits": { "smithy.api#documentation": "

A set of custom game session properties, formatted as a single string value. This data is passed to a game server process with a request to start a new game session. For more information, see Start a game session.

" } + }, + "PriorityConfigurationOverride": { + "target": "com.amazonaws.gamelift#PriorityConfigurationOverride", + "traits": { + "smithy.api#documentation": "

A prioritized list of locations to use for the game session placement and instructions\n on how to use it. This list overrides a queue's prioritized location list for this game\n session placement request only. You can include Amazon Web Services Regions, local zones, and custom\n locations (for Anywhere fleets). Choose a fallback strategy to instruct Amazon GameLift to use\n the override list for the first placement attempt only or for all placement\n attempts.

" + } } }, "traits": { @@ -17575,7 +17641,7 @@ } ], "traits": { - "smithy.api#documentation": "

Ends a game session that's currently in progress. You can use this action to terminate\n any game session that isn't in TERMINATED or TERMINATING\n status. Terminating a game session is the most efficient way to free up a server process\n when it's hosting a game session that's in a bad state or not ending naturally. You can\n use this action to terminate a game session that's being hosted on any type of Amazon GameLift\n fleet compute, including computes for managed EC2, managed container, and Anywhere\n fleets.

\n

There are two potential methods for terminating a game session:

\n \n

\n Request options\n

\n \n

\n Results\n

\n

If successful, game session termination is initiated, which includes changing the game\n session status to TERMINATING. As a result of this action, and depending on\n the implementation of OnProcessTerminate(), the server process either\n becomes available to host a new game session, or it's recycled and a new server process\n started with availability to host a game session. The game session status is changed to\n TERMINATED, with a status reason that indicates the termination method\n used.

" + "smithy.api#documentation": "

Ends a game session that's currently in progress. Use this action to terminate any\n game session that isn't in ERROR status. Terminating a game session is the\n most efficient way to free up a server process when it's hosting a game session that's\n in a bad state or not ending properly. You can use this action to terminate a game\n session that's being hosted on any type of Amazon GameLift fleet compute, including computes for\n managed EC2, managed container, and Anywhere fleets. The game server must be integrated\n with Amazon GameLift server SDK 5.x or greater.

\n

\n Request options\n

\n

Request termination for a single game session. Provide the game session ID and the\n termination mode. There are two potential methods for terminating a game session:

\n \n

\n Results\n

\n

If successful, game session termination is initiated. During this activity, the game\n session status is changed to TERMINATING. When completed, the server\n process that was hosting the game session has been stopped and replaced with a new\n server process that's ready to host a new game session. The old game session's status is\n changed to TERMINATED with a status reason that indicates the termination\n method used.

\n

\n Learn more\n

\n

\n Add Amazon GameLift to your game server\n

\n

Amazon GameLift server SDK 5 reference guide for OnProcessTerminate()\n (C++)\n (C#) \n (Unreal) \n (Go)\n

" } }, "com.amazonaws.gamelift#TerminateGameSessionInput": { @@ -17593,7 +17659,7 @@ "target": "com.amazonaws.gamelift#TerminationMode", "traits": { "smithy.api#clientOptional": {}, - "smithy.api#documentation": "

The method to use to terminate the game session. Available methods include:

\n ", + "smithy.api#documentation": "

The method to use to terminate the game session. Available methods include:

\n ", "smithy.api#required": {} } } diff --git a/codegen/sdk-codegen/aws-models/route-53.json b/codegen/sdk-codegen/aws-models/route-53.json index 99a525102a8..92f3b785e09 100644 --- a/codegen/sdk-codegen/aws-models/route-53.json +++ b/codegen/sdk-codegen/aws-models/route-53.json @@ -3450,6 +3450,12 @@ "smithy.api#enumValue": "ap-southeast-5" } }, + "mx_central_1": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "mx-central-1" + } + }, "ap_southeast_7": { "target": "smithy.api#Unit", "traits": { @@ -10891,6 +10897,12 @@ "smithy.api#enumValue": "ap-southeast-5" } }, + "mx_central_1": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "mx-central-1" + } + }, "ap_southeast_7": { "target": "smithy.api#Unit", "traits": { @@ -12531,6 +12543,12 @@ "smithy.api#enumValue": "ap-southeast-5" } }, + "mx_central_1": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "mx-central-1" + } + }, "ap_southeast_7": { "target": "smithy.api#Unit", "traits": {