@aws-sdk/client-gamelift 3.316.0 → 3.319.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -13
- package/dist-cjs/endpoint/ruleset.js +3 -3
- package/dist-cjs/models/models_0.js +1 -0
- package/dist-cjs/protocols/Aws_json1_1.js +3 -0
- package/dist-es/endpoint/ruleset.js +3 -3
- package/dist-es/models/models_0.js +1 -0
- package/dist-es/protocols/Aws_json1_1.js +3 -0
- package/dist-types/GameLift.d.ts +20 -20
- package/dist-types/GameLiftClient.d.ts +20 -20
- package/dist-types/commands/AcceptMatchCommand.d.ts +6 -6
- package/dist-types/commands/ClaimGameServerCommand.d.ts +16 -16
- package/dist-types/commands/CreateAliasCommand.d.ts +5 -5
- package/dist-types/commands/CreateBuildCommand.d.ts +16 -16
- package/dist-types/commands/CreateFleetCommand.d.ts +13 -13
- package/dist-types/commands/CreateFleetLocationsCommand.d.ts +11 -7
- package/dist-types/commands/CreateGameServerGroupCommand.d.ts +17 -17
- package/dist-types/commands/CreateGameSessionCommand.d.ts +11 -11
- package/dist-types/commands/CreateGameSessionQueueCommand.d.ts +10 -10
- package/dist-types/commands/CreateLocationCommand.d.ts +1 -1
- package/dist-types/commands/CreateMatchmakingConfigurationCommand.d.ts +9 -9
- package/dist-types/commands/CreateMatchmakingRuleSetCommand.d.ts +7 -7
- package/dist-types/commands/CreatePlayerSessionCommand.d.ts +7 -7
- package/dist-types/commands/CreatePlayerSessionsCommand.d.ts +8 -8
- package/dist-types/commands/CreateScriptCommand.d.ts +11 -12
- package/dist-types/commands/CreateVpcPeeringAuthorizationCommand.d.ts +5 -5
- package/dist-types/commands/CreateVpcPeeringConnectionCommand.d.ts +3 -3
- package/dist-types/commands/DeleteAliasCommand.d.ts +2 -2
- package/dist-types/commands/DeleteBuildCommand.d.ts +4 -4
- package/dist-types/commands/DeleteFleetCommand.d.ts +4 -4
- package/dist-types/commands/DeleteFleetLocationsCommand.d.ts +4 -4
- package/dist-types/commands/DeleteGameServerGroupCommand.d.ts +13 -13
- package/dist-types/commands/DeleteLocationCommand.d.ts +1 -1
- package/dist-types/commands/DeleteMatchmakingRuleSetCommand.d.ts +3 -3
- package/dist-types/commands/DeleteScalingPolicyCommand.d.ts +2 -2
- package/dist-types/commands/DeleteScriptCommand.d.ts +6 -6
- package/dist-types/commands/DeleteVpcPeeringAuthorizationCommand.d.ts +1 -1
- package/dist-types/commands/DeleteVpcPeeringConnectionCommand.d.ts +2 -2
- package/dist-types/commands/DeregisterGameServerCommand.d.ts +6 -6
- package/dist-types/commands/DescribeAliasCommand.d.ts +3 -3
- package/dist-types/commands/DescribeBuildCommand.d.ts +3 -3
- package/dist-types/commands/DescribeComputeCommand.d.ts +1 -1
- package/dist-types/commands/DescribeEC2InstanceLimitsCommand.d.ts +15 -15
- package/dist-types/commands/DescribeFleetAttributesCommand.d.ts +9 -9
- package/dist-types/commands/DescribeFleetCapacityCommand.d.ts +10 -10
- package/dist-types/commands/DescribeFleetEventsCommand.d.ts +3 -3
- package/dist-types/commands/DescribeFleetLocationAttributesCommand.d.ts +7 -7
- package/dist-types/commands/DescribeFleetLocationCapacityCommand.d.ts +4 -4
- package/dist-types/commands/DescribeFleetLocationUtilizationCommand.d.ts +4 -4
- package/dist-types/commands/DescribeFleetPortSettingsCommand.d.ts +7 -7
- package/dist-types/commands/DescribeFleetUtilizationCommand.d.ts +10 -10
- package/dist-types/commands/DescribeGameServerCommand.d.ts +6 -6
- package/dist-types/commands/DescribeGameServerGroupCommand.d.ts +7 -7
- package/dist-types/commands/DescribeGameServerInstancesCommand.d.ts +8 -8
- package/dist-types/commands/DescribeGameSessionDetailsCommand.d.ts +8 -8
- package/dist-types/commands/DescribeGameSessionPlacementCommand.d.ts +2 -2
- package/dist-types/commands/DescribeGameSessionQueuesCommand.d.ts +3 -3
- package/dist-types/commands/DescribeGameSessionsCommand.d.ts +10 -10
- package/dist-types/commands/DescribeInstancesCommand.d.ts +12 -12
- package/dist-types/commands/DescribeMatchmakingCommand.d.ts +6 -6
- package/dist-types/commands/DescribeMatchmakingConfigurationsCommand.d.ts +4 -4
- package/dist-types/commands/DescribeMatchmakingRuleSetsCommand.d.ts +3 -3
- package/dist-types/commands/DescribePlayerSessionsCommand.d.ts +9 -9
- package/dist-types/commands/DescribeRuntimeConfigurationCommand.d.ts +5 -5
- package/dist-types/commands/DescribeScalingPoliciesCommand.d.ts +2 -2
- package/dist-types/commands/DescribeScriptCommand.d.ts +6 -6
- package/dist-types/commands/DescribeVpcPeeringAuthorizationsCommand.d.ts +1 -1
- package/dist-types/commands/DescribeVpcPeeringConnectionsCommand.d.ts +2 -2
- package/dist-types/commands/GetComputeAccessCommand.d.ts +7 -7
- package/dist-types/commands/GetComputeAuthTokenCommand.d.ts +4 -4
- package/dist-types/commands/GetGameSessionLogUrlCommand.d.ts +4 -4
- package/dist-types/commands/GetInstanceAccessCommand.d.ts +9 -9
- package/dist-types/commands/ListAliasesCommand.d.ts +4 -4
- package/dist-types/commands/ListBuildsCommand.d.ts +5 -5
- package/dist-types/commands/ListFleetsCommand.d.ts +10 -10
- package/dist-types/commands/ListGameServersCommand.d.ts +5 -5
- package/dist-types/commands/ListScriptsCommand.d.ts +5 -5
- package/dist-types/commands/ListTagsForResourceCommand.d.ts +8 -31
- package/dist-types/commands/PutScalingPolicyCommand.d.ts +14 -14
- package/dist-types/commands/RegisterComputeCommand.d.ts +5 -5
- package/dist-types/commands/RegisterGameServerCommand.d.ts +10 -10
- package/dist-types/commands/RequestUploadCredentialsCommand.d.ts +5 -5
- package/dist-types/commands/ResolveAliasCommand.d.ts +2 -2
- package/dist-types/commands/ResumeGameServerGroupCommand.d.ts +6 -6
- package/dist-types/commands/SearchGameSessionsCommand.d.ts +20 -20
- package/dist-types/commands/StartFleetActionsCommand.d.ts +6 -6
- package/dist-types/commands/StartGameSessionPlacementCommand.d.ts +11 -11
- package/dist-types/commands/StartMatchBackfillCommand.d.ts +9 -9
- package/dist-types/commands/StartMatchmakingCommand.d.ts +8 -8
- package/dist-types/commands/StopFleetActionsCommand.d.ts +7 -7
- package/dist-types/commands/StopMatchmakingCommand.d.ts +5 -5
- package/dist-types/commands/SuspendGameServerGroupCommand.d.ts +8 -8
- package/dist-types/commands/TagResourceCommand.d.ts +10 -34
- package/dist-types/commands/UntagResourceCommand.d.ts +10 -34
- package/dist-types/commands/UpdateAliasCommand.d.ts +2 -2
- package/dist-types/commands/UpdateBuildCommand.d.ts +3 -3
- package/dist-types/commands/UpdateFleetAttributesCommand.d.ts +5 -5
- package/dist-types/commands/UpdateFleetCapacityCommand.d.ts +10 -10
- package/dist-types/commands/UpdateFleetPortSettingsCommand.d.ts +5 -5
- package/dist-types/commands/UpdateGameServerCommand.d.ts +12 -12
- package/dist-types/commands/UpdateGameServerGroupCommand.d.ts +8 -8
- package/dist-types/commands/UpdateGameSessionCommand.d.ts +5 -5
- package/dist-types/commands/UpdateGameSessionQueueCommand.d.ts +3 -3
- package/dist-types/commands/UpdateMatchmakingConfigurationCommand.d.ts +2 -2
- package/dist-types/commands/UpdateRuntimeConfigurationCommand.d.ts +5 -5
- package/dist-types/commands/UpdateScriptCommand.d.ts +8 -8
- package/dist-types/commands/ValidateMatchmakingRuleSetCommand.d.ts +3 -3
- package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/models/models_0.d.ts +591 -591
- package/dist-types/models/models_1.d.ts +22 -22
- package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/ts3.4/models/models_0.d.ts +1 -0
- package/package.json +5 -5
|
@@ -23,18 +23,18 @@ export interface ListBuildsCommandOutput extends ListBuildsOutput, __MetadataBea
|
|
|
23
23
|
* can limit results to builds that are in a specific status by using the
|
|
24
24
|
* <code>Status</code> parameter. Use the pagination parameters to retrieve results in
|
|
25
25
|
* a set of sequential pages. </p>
|
|
26
|
-
*
|
|
26
|
+
* <note>
|
|
27
27
|
* <p>Build resources are not listed in any particular order.</p>
|
|
28
|
-
*
|
|
29
|
-
*
|
|
28
|
+
* </note>
|
|
29
|
+
* <p>
|
|
30
30
|
* <b>Learn more</b>
|
|
31
31
|
* </p>
|
|
32
|
-
*
|
|
32
|
+
* <p>
|
|
33
33
|
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-intro.html"> Upload a Custom
|
|
34
34
|
* Server Build</a>
|
|
35
35
|
* </p>
|
|
36
36
|
* <p>
|
|
37
|
-
*
|
|
37
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
|
|
38
38
|
* </p>
|
|
39
39
|
* @example
|
|
40
40
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -24,32 +24,32 @@ export interface ListFleetsCommandOutput extends ListFleetsOutput, __MetadataBea
|
|
|
24
24
|
* specify a Region in your request. You can filter the result set to find only those
|
|
25
25
|
* fleets that are deployed with a specific build or script. For fleets that have multiple
|
|
26
26
|
* locations, this operation retrieves fleets based on their home Region only.</p>
|
|
27
|
-
*
|
|
28
|
-
*
|
|
27
|
+
* <p>This operation can be used in the following ways: </p>
|
|
28
|
+
* <ul>
|
|
29
29
|
* <li>
|
|
30
|
-
*
|
|
30
|
+
* <p>To get a list of all fleets in a Region, don't provide a build or script
|
|
31
31
|
* identifier. </p>
|
|
32
32
|
* </li>
|
|
33
33
|
* <li>
|
|
34
|
-
*
|
|
34
|
+
* <p>To get a list of all fleets where a specific custom game build is deployed,
|
|
35
35
|
* provide the build ID.</p>
|
|
36
36
|
* </li>
|
|
37
37
|
* <li>
|
|
38
|
-
*
|
|
38
|
+
* <p>To get a list of all Realtime Servers fleets with a specific configuration script,
|
|
39
39
|
* provide the script ID. </p>
|
|
40
40
|
* </li>
|
|
41
41
|
* </ul>
|
|
42
|
-
*
|
|
43
|
-
*
|
|
42
|
+
* <p>Use the pagination parameters to retrieve results as a set of sequential pages. </p>
|
|
43
|
+
* <p>If successful, a list of fleet IDs that match the request parameters is returned. A
|
|
44
44
|
* NextToken value is also returned if there are more result pages to retrieve.</p>
|
|
45
|
-
*
|
|
45
|
+
* <note>
|
|
46
46
|
* <p>Fleet resources are not listed in a particular order.</p>
|
|
47
|
-
*
|
|
47
|
+
* </note>
|
|
48
48
|
* <p>
|
|
49
49
|
* <b>Learn more</b>
|
|
50
50
|
* </p>
|
|
51
51
|
* <p>
|
|
52
|
-
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html">Setting up GameLift
|
|
52
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html">Setting up Amazon GameLift
|
|
53
53
|
* fleets</a>
|
|
54
54
|
* </p>
|
|
55
55
|
* @example
|
|
@@ -20,19 +20,19 @@ export interface ListGameServersCommandOutput extends ListGameServersOutput, __M
|
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
22
|
* <p>
|
|
23
|
-
* <b>This operation is used with the GameLift FleetIQ solution and game server groups.</b>
|
|
23
|
+
* <b>This operation is used with the Amazon GameLift FleetIQ solution and game server groups.</b>
|
|
24
24
|
* </p>
|
|
25
25
|
* <p>Retrieves information on all game
|
|
26
26
|
* servers that are currently active in a specified game server group. You can opt to sort
|
|
27
27
|
* the list by game server age. Use the pagination parameters to retrieve results in a set
|
|
28
28
|
* of sequential segments. </p>
|
|
29
|
-
*
|
|
29
|
+
* <p>
|
|
30
30
|
* <b>Learn more</b>
|
|
31
31
|
* </p>
|
|
32
|
-
*
|
|
33
|
-
* <a href="https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html">GameLift FleetIQ
|
|
32
|
+
* <p>
|
|
33
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html">Amazon GameLift FleetIQ
|
|
34
34
|
* Guide</a>
|
|
35
|
-
*
|
|
35
|
+
* </p>
|
|
36
36
|
* @example
|
|
37
37
|
* Use a bare-bones client and the command you need to make an API call.
|
|
38
38
|
* ```javascript
|
|
@@ -21,17 +21,17 @@ export interface ListScriptsCommandOutput extends ListScriptsOutput, __MetadataB
|
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Retrieves script records for all Realtime scripts that are associated with the Amazon Web Services
|
|
23
23
|
* account in use. </p>
|
|
24
|
-
*
|
|
24
|
+
* <p>
|
|
25
25
|
* <b>Learn more</b>
|
|
26
26
|
* </p>
|
|
27
|
-
*
|
|
27
|
+
* <p>
|
|
28
28
|
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-intro.html">Amazon GameLift Realtime Servers</a>
|
|
29
|
-
*
|
|
29
|
+
* </p>
|
|
30
30
|
* <p>
|
|
31
31
|
* <b>Related actions</b>
|
|
32
32
|
* </p>
|
|
33
|
-
*
|
|
34
|
-
*
|
|
33
|
+
* <p>
|
|
34
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
|
|
35
35
|
* </p>
|
|
36
36
|
* @example
|
|
37
37
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -19,48 +19,25 @@ export interface ListTagsForResourceCommandOutput extends ListTagsForResourceRes
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
|
-
* <p>Retrieves all tags
|
|
23
|
-
*
|
|
24
|
-
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
* <p>Build</p>
|
|
28
|
-
* </li>
|
|
29
|
-
* <li>
|
|
30
|
-
* <p>Script</p>
|
|
31
|
-
* </li>
|
|
32
|
-
* <li>
|
|
33
|
-
* <p>Fleet</p>
|
|
34
|
-
* </li>
|
|
35
|
-
* <li>
|
|
36
|
-
* <p>Alias</p>
|
|
37
|
-
* </li>
|
|
38
|
-
* <li>
|
|
39
|
-
* <p>GameSessionQueue</p>
|
|
40
|
-
* </li>
|
|
41
|
-
* <li>
|
|
42
|
-
* <p>MatchmakingConfiguration</p>
|
|
43
|
-
* </li>
|
|
44
|
-
* <li>
|
|
45
|
-
* <p>MatchmakingRuleSet</p>
|
|
46
|
-
* </li>
|
|
47
|
-
* </ul>
|
|
48
|
-
* <p>To list tags for a resource, specify the unique ARN value for the resource.</p>
|
|
49
|
-
* <p>
|
|
22
|
+
* <p>Retrieves all tags assigned to a Amazon GameLift resource. Use resource tags to organize Amazon Web Services
|
|
23
|
+
* resources for a range of purposes. This operation handles the permissions necessary to
|
|
24
|
+
* manage tags for Amazon GameLift resources that support tagging.</p>
|
|
25
|
+
* <p>To list tags for a resource, specify the unique ARN value for the resource.</p>
|
|
26
|
+
* <p>
|
|
50
27
|
* <b>Learn more</b>
|
|
51
28
|
* </p>
|
|
52
|
-
*
|
|
29
|
+
* <p>
|
|
53
30
|
* <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services
|
|
54
31
|
* Resources</a> in the <i>Amazon Web Services General Reference</i>
|
|
55
32
|
* </p>
|
|
56
|
-
*
|
|
33
|
+
* <p>
|
|
57
34
|
* <a href="http://aws.amazon.com/answers/account-management/aws-tagging-strategies/">
|
|
58
35
|
* Amazon Web Services Tagging Strategies</a>
|
|
59
36
|
* </p>
|
|
60
37
|
* <p>
|
|
61
38
|
* <b>Related actions</b>
|
|
62
39
|
* </p>
|
|
63
|
-
*
|
|
40
|
+
* <p>
|
|
64
41
|
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
|
|
65
42
|
* </p>
|
|
66
43
|
* @example
|
|
@@ -26,52 +26,52 @@ export interface PutScalingPolicyCommandOutput extends PutScalingPolicyOutput, _
|
|
|
26
26
|
* target-based and rule-based. Use a target-based policy to quickly and efficiently manage
|
|
27
27
|
* fleet scaling; this option is the most commonly used. Use rule-based policies when you
|
|
28
28
|
* need to exert fine-grained control over auto-scaling. </p>
|
|
29
|
-
*
|
|
29
|
+
* <p>Fleets can have multiple scaling policies of each type in force at the same time; you
|
|
30
30
|
* can have one target-based policy, one or multiple rule-based scaling policies, or both.
|
|
31
31
|
* We recommend caution, however, because multiple auto-scaling policies can have
|
|
32
32
|
* unintended consequences.</p>
|
|
33
|
-
*
|
|
33
|
+
* <p>Learn more about how to work with auto-scaling in <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-autoscaling.html">Set Up Fleet Automatic
|
|
34
34
|
* Scaling</a>.</p>
|
|
35
|
-
*
|
|
35
|
+
* <p>
|
|
36
36
|
* <b>Target-based policy</b>
|
|
37
37
|
* </p>
|
|
38
|
-
*
|
|
38
|
+
* <p>A target-based policy tracks a single metric: PercentAvailableGameSessions. This
|
|
39
39
|
* metric tells us how much of a fleet's hosting capacity is ready to host game sessions
|
|
40
40
|
* but is not currently in use. This is the fleet's buffer; it measures the additional
|
|
41
41
|
* player demand that the fleet could handle at current capacity. With a target-based
|
|
42
42
|
* policy, you set your ideal buffer size and leave it to Amazon GameLift to take whatever action is
|
|
43
43
|
* needed to maintain that target. </p>
|
|
44
|
-
*
|
|
44
|
+
* <p>For example, you might choose to maintain a 10% buffer for a fleet that has the
|
|
45
45
|
* capacity to host 100 simultaneous game sessions. This policy tells Amazon GameLift to take action
|
|
46
46
|
* whenever the fleet's available capacity falls below or rises above 10 game sessions.
|
|
47
47
|
* Amazon GameLift will start new instances or stop unused instances in order to return to the 10%
|
|
48
48
|
* buffer. </p>
|
|
49
|
-
*
|
|
49
|
+
* <p>To create or update a target-based policy, specify a fleet ID and name, and set the
|
|
50
50
|
* policy type to "TargetBased". Specify the metric to track (PercentAvailableGameSessions)
|
|
51
51
|
* and reference a <code>TargetConfiguration</code> object with your desired buffer value.
|
|
52
52
|
* Exclude all other parameters. On a successful request, the policy name is returned. The
|
|
53
53
|
* scaling policy is automatically in force as soon as it's successfully created. If the
|
|
54
54
|
* fleet's auto-scaling actions are temporarily suspended, the new policy will be in force
|
|
55
55
|
* once the fleet actions are restarted.</p>
|
|
56
|
-
*
|
|
56
|
+
* <p>
|
|
57
57
|
* <b>Rule-based policy</b>
|
|
58
58
|
* </p>
|
|
59
|
-
*
|
|
59
|
+
* <p>A rule-based policy tracks specified fleet metric, sets a threshold value, and
|
|
60
60
|
* specifies the type of action to initiate when triggered. With a rule-based policy, you
|
|
61
61
|
* can select from several available fleet metrics. Each policy specifies whether to scale
|
|
62
62
|
* up or scale down (and by how much), so you need one policy for each type of action. </p>
|
|
63
|
-
*
|
|
63
|
+
* <p>For example, a policy may make the following statement: "If the percentage of idle
|
|
64
64
|
* instances is greater than 20% for more than 15 minutes, then reduce the fleet capacity
|
|
65
65
|
* by 10%."</p>
|
|
66
|
-
*
|
|
67
|
-
*
|
|
66
|
+
* <p>A policy's rule statement has the following structure:</p>
|
|
67
|
+
* <p>If <code>[MetricName]</code> is <code>[ComparisonOperator]</code>
|
|
68
68
|
* <code>[Threshold]</code> for <code>[EvaluationPeriods]</code> minutes, then
|
|
69
69
|
* <code>[ScalingAdjustmentType]</code> to/by <code>[ScalingAdjustment]</code>.</p>
|
|
70
|
-
*
|
|
71
|
-
*
|
|
70
|
+
* <p>To implement the example, the rule statement would look like this:</p>
|
|
71
|
+
* <p>If <code>[PercentIdleInstances]</code> is <code>[GreaterThanThreshold]</code>
|
|
72
72
|
* <code>[20]</code> for <code>[15]</code> minutes, then
|
|
73
73
|
* <code>[PercentChangeInCapacity]</code> to/by <code>[10]</code>.</p>
|
|
74
|
-
*
|
|
74
|
+
* <p>To create or update a scaling policy, specify a unique combination of name and fleet
|
|
75
75
|
* ID, and set the policy type to "RuleBased". Specify the parameter values for a policy
|
|
76
76
|
* rule statement. On a successful request, the policy name is returned. Scaling policies
|
|
77
77
|
* are automatically in force as soon as they're successfully created. If the fleet's
|
|
@@ -20,21 +20,21 @@ export interface RegisterComputeCommandOutput extends RegisterComputeOutput, __M
|
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Registers your compute resources in a fleet you previously created. After you register
|
|
23
|
-
* a compute to your fleet, you can monitor and manage your compute using GameLift. The
|
|
23
|
+
* a compute to your fleet, you can monitor and manage your compute using Amazon GameLift. The
|
|
24
24
|
* operation returns the compute resource containing SDK endpoint you can use to connect
|
|
25
|
-
* your game server to GameLift.</p>
|
|
25
|
+
* your game server to Amazon GameLift.</p>
|
|
26
26
|
* <p>
|
|
27
27
|
* <b>Learn more</b>
|
|
28
28
|
* </p>
|
|
29
29
|
* <ul>
|
|
30
30
|
* <li>
|
|
31
|
-
*
|
|
31
|
+
* <p>
|
|
32
32
|
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-anywhere.html">Create an
|
|
33
33
|
* Anywhere fleet</a>
|
|
34
34
|
* </p>
|
|
35
35
|
* </li>
|
|
36
36
|
* <li>
|
|
37
|
-
*
|
|
37
|
+
* <p>
|
|
38
38
|
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-testing.html">Test your
|
|
39
39
|
* integration</a>
|
|
40
40
|
* </p>
|
|
@@ -68,7 +68,7 @@ export interface RegisterComputeCommandOutput extends RegisterComputeOutput, __M
|
|
|
68
68
|
* <p>The requested operation would cause a conflict with the current state of a service
|
|
69
69
|
* resource associated with the request. Resolve the conflict before retrying this
|
|
70
70
|
* request.</p>
|
|
71
|
-
*
|
|
71
|
+
* <p></p>
|
|
72
72
|
*
|
|
73
73
|
* @throws {@link InternalServiceException} (server fault)
|
|
74
74
|
* <p>The service encountered an unrecoverable internal failure while processing the
|
|
@@ -20,28 +20,28 @@ export interface RegisterGameServerCommandOutput extends RegisterGameServerOutpu
|
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
22
|
* <p>
|
|
23
|
-
* <b>This operation is used with the GameLift FleetIQ solution and game server groups.</b>
|
|
23
|
+
* <b>This operation is used with the Amazon GameLift FleetIQ solution and game server groups.</b>
|
|
24
24
|
* </p>
|
|
25
25
|
* <p>Creates a new game server
|
|
26
|
-
* resource and notifies GameLift FleetIQ that the game server is ready to host gameplay and players.
|
|
26
|
+
* resource and notifies Amazon GameLift FleetIQ that the game server is ready to host gameplay and players.
|
|
27
27
|
* This operation is called by a game server process that is running on an instance in a
|
|
28
|
-
* game server group. Registering game servers enables GameLift FleetIQ to track available game
|
|
28
|
+
* game server group. Registering game servers enables Amazon GameLift FleetIQ to track available game
|
|
29
29
|
* servers and enables game clients and services to claim a game server for a new game
|
|
30
30
|
* session. </p>
|
|
31
|
-
*
|
|
31
|
+
* <p>To register a game server, identify the game server group and instance where the game
|
|
32
32
|
* server is running, and provide a unique identifier for the game server. You can also
|
|
33
33
|
* include connection and game server data.</p>
|
|
34
|
-
*
|
|
34
|
+
* <p>Once a game server is successfully registered, it is put in status
|
|
35
35
|
* <code>AVAILABLE</code>. A request to register a game server may fail if the instance
|
|
36
36
|
* it is running on is in the process of shutting down as part of instance balancing or
|
|
37
37
|
* scale-down activity. </p>
|
|
38
|
-
*
|
|
38
|
+
* <p>
|
|
39
39
|
* <b>Learn more</b>
|
|
40
40
|
* </p>
|
|
41
|
-
*
|
|
42
|
-
* <a href="https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html">GameLift FleetIQ
|
|
41
|
+
* <p>
|
|
42
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html">Amazon GameLift FleetIQ
|
|
43
43
|
* Guide</a>
|
|
44
|
-
*
|
|
44
|
+
* </p>
|
|
45
45
|
* @example
|
|
46
46
|
* Use a bare-bones client and the command you need to make an API call.
|
|
47
47
|
* ```javascript
|
|
@@ -69,7 +69,7 @@ export interface RegisterGameServerCommandOutput extends RegisterGameServerOutpu
|
|
|
69
69
|
* <p>The requested operation would cause a conflict with the current state of a service
|
|
70
70
|
* resource associated with the request. Resolve the conflict before retrying this
|
|
71
71
|
* request.</p>
|
|
72
|
-
*
|
|
72
|
+
* <p></p>
|
|
73
73
|
*
|
|
74
74
|
* @throws {@link InternalServiceException} (server fault)
|
|
75
75
|
* <p>The service encountered an unrecoverable internal failure while processing the
|
|
@@ -22,17 +22,17 @@ export interface RequestUploadCredentialsCommandOutput extends RequestUploadCred
|
|
|
22
22
|
* <p>Retrieves a fresh set of credentials for use when uploading a new set of game build
|
|
23
23
|
* files to Amazon GameLift's Amazon S3. This is done as part of the build creation process; see
|
|
24
24
|
* <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateBuild.html">GameSession</a>.</p>
|
|
25
|
-
*
|
|
25
|
+
* <p>To request new credentials, specify the build ID as returned with an initial
|
|
26
26
|
* <code>CreateBuild</code> request. If successful, a new set of credentials are
|
|
27
27
|
* returned, along with the S3 storage location associated with the build ID.</p>
|
|
28
|
-
*
|
|
28
|
+
* <p>
|
|
29
29
|
* <b>Learn more</b>
|
|
30
30
|
* </p>
|
|
31
|
-
*
|
|
31
|
+
* <p>
|
|
32
32
|
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-create-build"> Create a Build with Files in S3</a>
|
|
33
|
-
*
|
|
33
|
+
* </p>
|
|
34
34
|
* <p>
|
|
35
|
-
*
|
|
35
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
|
|
36
36
|
* </p>
|
|
37
37
|
* @example
|
|
38
38
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -23,8 +23,8 @@ export interface ResolveAliasCommandOutput extends ResolveAliasOutput, __Metadat
|
|
|
23
23
|
* <p>
|
|
24
24
|
* <b>Related actions</b>
|
|
25
25
|
* </p>
|
|
26
|
-
*
|
|
27
|
-
*
|
|
26
|
+
* <p>
|
|
27
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
|
|
28
28
|
* </p>
|
|
29
29
|
* @example
|
|
30
30
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -20,7 +20,7 @@ export interface ResumeGameServerGroupCommandOutput extends ResumeGameServerGrou
|
|
|
20
20
|
/**
|
|
21
21
|
* @public
|
|
22
22
|
* <p>
|
|
23
|
-
* <b>This operation is used with the GameLift FleetIQ solution and game server groups.</b>
|
|
23
|
+
* <b>This operation is used with the Amazon GameLift FleetIQ solution and game server groups.</b>
|
|
24
24
|
* </p>
|
|
25
25
|
* <p>Reinstates activity on a game
|
|
26
26
|
* server group after it has been suspended. A game server group might be suspended by the
|
|
@@ -29,16 +29,16 @@ export interface ResumeGameServerGroupCommandOutput extends ResumeGameServerGrou
|
|
|
29
29
|
* the group once the configuration problem has been resolved. Refer to the game server
|
|
30
30
|
* group status and status reason for more information on why group activity is
|
|
31
31
|
* suspended.</p>
|
|
32
|
-
*
|
|
32
|
+
* <p>To resume activity, specify a game server group ARN and the type of activity to be
|
|
33
33
|
* resumed. If successful, a <code>GameServerGroup</code> object is returned showing that
|
|
34
34
|
* the resumed activity is no longer listed in <code>SuspendedActions</code>. </p>
|
|
35
|
-
*
|
|
35
|
+
* <p>
|
|
36
36
|
* <b>Learn more</b>
|
|
37
37
|
* </p>
|
|
38
|
-
*
|
|
39
|
-
* <a href="https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html">GameLift FleetIQ
|
|
38
|
+
* <p>
|
|
39
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html">Amazon GameLift FleetIQ
|
|
40
40
|
* Guide</a>
|
|
41
|
-
*
|
|
41
|
+
* </p>
|
|
42
42
|
* @example
|
|
43
43
|
* Use a bare-bones client and the command you need to make an API call.
|
|
44
44
|
* ```javascript
|
|
@@ -21,47 +21,47 @@ export interface SearchGameSessionsCommandOutput extends SearchGameSessionsOutpu
|
|
|
21
21
|
* @public
|
|
22
22
|
* <p>Retrieves all active game sessions that match a set of search criteria and sorts them
|
|
23
23
|
* into a specified order. </p>
|
|
24
|
-
*
|
|
24
|
+
* <p>This operation is not designed to be continually called to track game session status.
|
|
25
25
|
* This practice can cause you to exceed your API limit, which results in errors. Instead,
|
|
26
26
|
* you must configure configure an Amazon Simple Notification Service (SNS) topic to receive notifications from
|
|
27
27
|
* FlexMatch or queues. Continuously polling game session status with
|
|
28
28
|
* <code>DescribeGameSessions</code> should only be used for games in development with
|
|
29
29
|
* low game session usage. </p>
|
|
30
|
-
*
|
|
30
|
+
* <p>When searching for game sessions, you specify exactly where you want to search and
|
|
31
31
|
* provide a search filter expression, a sort expression, or both. A search request can
|
|
32
32
|
* search only one fleet, but it can search all of a fleet's locations. </p>
|
|
33
|
-
*
|
|
34
|
-
*
|
|
33
|
+
* <p>This operation can be used in the following ways: </p>
|
|
34
|
+
* <ul>
|
|
35
35
|
* <li>
|
|
36
|
-
*
|
|
36
|
+
* <p>To search all game sessions that are currently running on all locations in a
|
|
37
37
|
* fleet, provide a fleet or alias ID. This approach returns game sessions in the
|
|
38
38
|
* fleet's home Region and all remote locations that fit the search
|
|
39
39
|
* criteria.</p>
|
|
40
40
|
* </li>
|
|
41
41
|
* <li>
|
|
42
|
-
*
|
|
42
|
+
* <p>To search all game sessions that are currently running on a specific fleet
|
|
43
43
|
* location, provide a fleet or alias ID and a location name. For location, you can
|
|
44
44
|
* specify a fleet's home Region or any remote location.</p>
|
|
45
45
|
* </li>
|
|
46
46
|
* </ul>
|
|
47
|
-
*
|
|
48
|
-
*
|
|
47
|
+
* <p>Use the pagination parameters to retrieve results as a set of sequential pages. </p>
|
|
48
|
+
* <p>If successful, a <code>GameSession</code> object is returned for each game session
|
|
49
49
|
* that matches the request. Search finds game sessions that are in <code>ACTIVE</code>
|
|
50
50
|
* status only. To retrieve information on game sessions in other statuses, use <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessions.html">DescribeGameSessions</a> .</p>
|
|
51
|
-
*
|
|
52
|
-
*
|
|
51
|
+
* <p>You can search or sort by the following game session attributes:</p>
|
|
52
|
+
* <ul>
|
|
53
53
|
* <li>
|
|
54
|
-
*
|
|
54
|
+
* <p>
|
|
55
55
|
* <b>gameSessionId</b> -- A unique identifier for the game session. You can use either a
|
|
56
56
|
* <code>GameSessionId</code> or <code>GameSessionArn</code> value. </p>
|
|
57
57
|
* </li>
|
|
58
58
|
* <li>
|
|
59
|
-
*
|
|
59
|
+
* <p>
|
|
60
60
|
* <b>gameSessionName</b> -- Name assigned to a game
|
|
61
61
|
* session. Game session names do not need to be unique to a game session.</p>
|
|
62
62
|
* </li>
|
|
63
63
|
* <li>
|
|
64
|
-
*
|
|
64
|
+
* <p>
|
|
65
65
|
* <b>gameSessionProperties</b> -- Custom data defined
|
|
66
66
|
* in a game session's <code>GameProperty</code> parameter.
|
|
67
67
|
* <code>GameProperty</code> values are stored as key:value pairs; the filter
|
|
@@ -72,23 +72,23 @@ export interface SearchGameSessionsCommandOutput extends SearchGameSessionsOutpu
|
|
|
72
72
|
* values are searched as strings.</p>
|
|
73
73
|
* </li>
|
|
74
74
|
* <li>
|
|
75
|
-
*
|
|
75
|
+
* <p>
|
|
76
76
|
* <b>maximumSessions</b> -- Maximum number of player
|
|
77
77
|
* sessions allowed for a game session.</p>
|
|
78
78
|
* </li>
|
|
79
79
|
* <li>
|
|
80
|
-
*
|
|
80
|
+
* <p>
|
|
81
81
|
* <b>creationTimeMillis</b> -- Value indicating when a
|
|
82
82
|
* game session was created. It is expressed in Unix time as milliseconds.</p>
|
|
83
83
|
* </li>
|
|
84
84
|
* <li>
|
|
85
|
-
*
|
|
85
|
+
* <p>
|
|
86
86
|
* <b>playerSessionCount</b> -- Number of players
|
|
87
87
|
* currently connected to a game session. This value changes rapidly as players
|
|
88
88
|
* join the session or drop out.</p>
|
|
89
89
|
* </li>
|
|
90
90
|
* <li>
|
|
91
|
-
*
|
|
91
|
+
* <p>
|
|
92
92
|
* <b>hasAvailablePlayerSessions</b> -- Boolean value
|
|
93
93
|
* indicating whether a game session has reached its maximum number of players. It
|
|
94
94
|
* is highly recommended that all search requests include this filter attribute to
|
|
@@ -96,15 +96,15 @@ export interface SearchGameSessionsCommandOutput extends SearchGameSessionsOutpu
|
|
|
96
96
|
* </p>
|
|
97
97
|
* </li>
|
|
98
98
|
* </ul>
|
|
99
|
-
*
|
|
99
|
+
* <note>
|
|
100
100
|
* <p>Returned values for <code>playerSessionCount</code> and
|
|
101
101
|
* <code>hasAvailablePlayerSessions</code> change quickly as players join sessions
|
|
102
102
|
* and others drop out. Results should be considered a snapshot in time. Be sure to
|
|
103
103
|
* refresh search results often, and handle sessions that fill up before a player can
|
|
104
104
|
* join. </p>
|
|
105
|
-
*
|
|
105
|
+
* </note>
|
|
106
106
|
* <p>
|
|
107
|
-
*
|
|
107
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
|
|
108
108
|
* </p>
|
|
109
109
|
* @example
|
|
110
110
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -22,25 +22,25 @@ export interface StartFleetActionsCommandOutput extends StartFleetActionsOutput,
|
|
|
22
22
|
* <p>Resumes certain types of activity on fleet instances that were suspended with <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_StopFleetActions.html">StopFleetActions</a>. For multi-location fleets, fleet actions are managed
|
|
23
23
|
* separately for each location. Currently, this operation is used to restart a fleet's
|
|
24
24
|
* auto-scaling activity.</p>
|
|
25
|
-
*
|
|
26
|
-
*
|
|
25
|
+
* <p>This operation can be used in the following ways: </p>
|
|
26
|
+
* <ul>
|
|
27
27
|
* <li>
|
|
28
|
-
*
|
|
28
|
+
* <p>To restart actions on instances in the fleet's home Region, provide a fleet ID
|
|
29
29
|
* and the type of actions to resume. </p>
|
|
30
30
|
* </li>
|
|
31
31
|
* <li>
|
|
32
|
-
*
|
|
32
|
+
* <p>To restart actions on instances in one of the fleet's remote locations,
|
|
33
33
|
* provide a fleet ID, a location name, and the type of actions to resume. </p>
|
|
34
34
|
* </li>
|
|
35
35
|
* </ul>
|
|
36
|
-
*
|
|
36
|
+
* <p>If successful, Amazon GameLift once again initiates scaling events as triggered by the fleet's
|
|
37
37
|
* scaling policies. If actions on the fleet location were never stopped, this operation
|
|
38
38
|
* will have no effect.</p>
|
|
39
39
|
* <p>
|
|
40
40
|
* <b>Learn more</b>
|
|
41
41
|
* </p>
|
|
42
42
|
* <p>
|
|
43
|
-
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html">Setting up GameLift
|
|
43
|
+
* <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html">Setting up Amazon GameLift
|
|
44
44
|
* fleets</a>
|
|
45
45
|
* </p>
|
|
46
46
|
* @example
|
|
@@ -22,40 +22,40 @@ export interface StartGameSessionPlacementCommandOutput extends StartGameSession
|
|
|
22
22
|
* <p>Places a request for a new game session in a queue. When processing a placement
|
|
23
23
|
* request, Amazon GameLift searches for available resources on the queue's destinations, scanning
|
|
24
24
|
* each until it finds resources or the placement request times out.</p>
|
|
25
|
-
*
|
|
25
|
+
* <p>A game session placement request can also request player sessions. When a new game
|
|
26
26
|
* session is successfully created, Amazon GameLift creates a player session for each player
|
|
27
27
|
* included in the request.</p>
|
|
28
|
-
*
|
|
28
|
+
* <p>When placing a game session, by default Amazon GameLift tries each fleet in the order they are
|
|
29
29
|
* listed in the queue configuration. Ideally, a queue's destinations are listed in
|
|
30
30
|
* preference order.</p>
|
|
31
|
-
*
|
|
31
|
+
* <p>Alternatively, when requesting a game session with players, you can also provide
|
|
32
32
|
* latency data for each player in relevant Regions. Latency data indicates the performance
|
|
33
33
|
* lag a player experiences when connected to a fleet in the Region. Amazon GameLift uses latency
|
|
34
34
|
* data to reorder the list of destinations to place the game session in a Region with
|
|
35
35
|
* minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each
|
|
36
36
|
* Region's average lag for all players and reorders to get the best game play across all
|
|
37
37
|
* players. </p>
|
|
38
|
-
*
|
|
39
|
-
*
|
|
38
|
+
* <p>To place a new game session request, specify the following:</p>
|
|
39
|
+
* <ul>
|
|
40
40
|
* <li>
|
|
41
|
-
*
|
|
41
|
+
* <p>The queue name and a set of game session properties and settings</p>
|
|
42
42
|
* </li>
|
|
43
43
|
* <li>
|
|
44
|
-
*
|
|
44
|
+
* <p>A unique ID (such as a UUID) for the placement. You use this ID to track the
|
|
45
45
|
* status of the placement request</p>
|
|
46
46
|
* </li>
|
|
47
47
|
* <li>
|
|
48
|
-
*
|
|
48
|
+
* <p>(Optional) A set of player data and a unique player ID for each player that
|
|
49
49
|
* you are joining to the new game session (player data is optional, but if you
|
|
50
50
|
* include it, you must also provide a unique ID for each player)</p>
|
|
51
51
|
* </li>
|
|
52
52
|
* <li>
|
|
53
|
-
*
|
|
53
|
+
* <p>Latency data for all players (if you want to optimize game play for the
|
|
54
54
|
* players)</p>
|
|
55
55
|
* </li>
|
|
56
56
|
* </ul>
|
|
57
|
-
*
|
|
58
|
-
*
|
|
57
|
+
* <p>If successful, a new game session placement is created.</p>
|
|
58
|
+
* <p>To track the status of a placement request, call <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionPlacement.html">DescribeGameSessionPlacement</a> and check the request's status. If the status
|
|
59
59
|
* is <code>FULFILLED</code>, a new game session has been created and a game session ARN
|
|
60
60
|
* and Region are referenced. If the placement request times out, you can resubmit the
|
|
61
61
|
* request or retry it with a different queue. </p>
|