AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
Terminates a game server group and permanently deletes the game server group record. You have several options for how these resources are impacted when deleting the game server group. Depending on the type of delete operation selected, this operation might affect these resources:
The game server group
The corresponding Auto Scaling group
All game servers that are currently running in the group
To delete a game server group, identify the game server group to delete and specify
the type of delete operation to initiate. Game server groups can only be deleted if
they are in ACTIVE or ERROR status.
If the delete request is successful, a series of operations are kicked off. The game
server group status is changed to DELETE_SCHEDULED, which prevents new game
servers from being registered and stops automatic scaling activity. Once all game
servers in the game server group are deregistered, Amazon GameLift FleetIQ can begin
deleting resources. If any of the delete operations fail, the game server group is
placed in ERROR status.
Amazon GameLift FleetIQ emits delete events to Amazon CloudWatch.
Learn more
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginDeleteGameServerGroup and EndDeleteGameServerGroup.
Namespace: Amazon.GameLift
Assembly: AWSSDK.GameLift.dll
Version: 3.x.y.z
public virtual Task<DeleteGameServerGroupResponse> DeleteGameServerGroupAsync( DeleteGameServerGroupRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the DeleteGameServerGroup service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| InternalServiceException | The service encountered an unrecoverable internal failure while processing the request. Clients can retry such requests immediately or after a waiting period. |
| InvalidRequestException | One or more parameter values in the request are invalid. Correct the invalid parameter values before retrying. |
| NotFoundException | The requested resources was not found. The resource was either not created yet or deleted. |
| UnauthorizedException | The client failed authentication. Clients should not retry such requests. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer