Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# SDK del servidor de Go para Amazon GameLift Servers: acciones
<a name="integration-server-sdk-go-actions"></a>

Utilice la referencia del SDK 5.x del servidor para integrar su juego multijugador para el alojamiento con Amazon GameLift Servers. Para obtener ayuda con el proceso de integración, consulte [Adición de Amazon GameLift Servers al servidor de juegos con el SDK del servidor](gamelift-sdk-server-api.md).

`GameLiftServerAPI.go` define las acciones del SDK del servidor Go.

# SDK del servidor de Go para Amazon GameLift Servers: tipos de datos
<a name="integration-server-sdk-go-datatypes"></a>

Utilice la referencia del SDK del servidor para integrar su juego multijugador para el alojamiento con Amazon GameLift Servers. Para obtener ayuda con el proceso de integración, consulte [Adición de Amazon GameLift Servers al servidor de juegos con el SDK del servidor](gamelift-sdk-server-api.md).

`GameLiftServerAPI.go` define las acciones del SDK del servidor Go.

[SDK del servidor de Go para Amazon GameLift Servers: acciones](integration-server-sdk-go-actions.md)

**Topics**
+ [LogParameters](#integration-server-sdk-go-dataypes-log)
+ [MetricsParameters](#integration-server-sdk-go-dataypes-metrics)
+ [ProcessParameters](#integration-server-sdk-go-dataypes-process)
+ [UpdateGameSession](#integration-server-sdk-go-dataypes-updategamesession)
+ [GameSession](#integration-server-sdk-go-dataypes-gamesession)
+ [ServerParameters](#integration-server-sdk-go-dataypes-serverparameters)
+ [StartMatchBackfillRequest](#integration-server-sdk-go-dataypes-startmatchbackfillrequest)
+ [Jugador](#integration-server-sdk-go-dataypes-player)
+ [DescribePlayerSessionsRequest](#integration-server-sdk-go-dataypes-playersessions)
+ [StopMatchBackfillRequest](#integration-server-sdk-go-dataypes-stopmatchbackfillrequest)
+ [GetFleetRoleCredentialsRequest](#integration-server-sdk-go-dataypes-getfleetrolecredentialsrequest)

## LogParameters
<a name="integration-server-sdk-go-dataypes-log"></a>

Un objeto que identifica los archivos generados durante una sesión de juego que quiere que Amazon GameLift Servers cargue y almacene una vez finalizada la sesión de juego. El servidor de juegos proporciona `LogParameters` a Amazon GameLift Servers como parte de un objeto `ProcessParameters` en una llamada a [ProcessReady()](integration-server-sdk-go-actions.md#integration-server-sdk-go-processready).


|  |  | 
| --- |--- |
|  **Propiedades**  | Descripción | 
| LogPaths |  Lista de las rutas de directorio a archivos de registro del servidor de juegos que desea que Amazon GameLift Servers almacene para futuros accesos. El proceso del servidor genera esos archivos durante una sesión de juego. Defina los nombres y las rutas de los archivos en el servidor de juegos y almacénelos en el directorio raíz de compilación del juego.  Las rutas del registro deben ser absolutas. Por ejemplo, si la compilación del juego almacena los registros de sesión de juego en una ruta del tipo `MyGame\sessionLogs\`, la ruta sería `c:\game\MyGame\sessionLogs` en una instancia de Windows. **Tipo:** `[]string` **Obligatorio**: no  | 

## MetricsParameters
<a name="integration-server-sdk-go-dataypes-metrics"></a>

Objeto que comunica los parámetros de configuración para inicializar el sistema de métricas. Esta configuración se utiliza para configurar los informes de StatsD, los informes de bloqueo y el comportamiento de procesamiento de las métricas. El servidor de juegos proporciona `MetricsParameters` a Amazon GameLift Servers como parte de una llamada a [InitMetrics()](integration-server-sdk-go-actions.md#integration-server-sdk-go-initmetrics).


|  |  | 
| --- |--- |
|  **Propiedades**  | Descripción | 
| StatsdHost |  Host del servidor de StatsD para los informes de métricas (por ejemplo, “localhost”). **Tipo:** `string` **Obligatorio**: sí  | 
| StatsdPort |  Puerto del servidor de StatsD para los informes de métricas (por ejemplo, 8125). **Tipo:** `int` **Obligatorio**: sí  | 
| CrashReporterHost |  Host del servidor que notifica el bloqueo con fines de seguimiento y supervisión de procesos. **Tipo:** `string` **Obligatorio**: sí  | 
| CrashReporterPort |  Puerto que notifica el bloqueo con fines de seguimiento y supervisión de procesos. **Tipo:** `int` **Obligatorio**: sí  | 
| FlushIntervalMs |  Intervalo de vaciado de métricas en milisegundos. Controla la frecuencia con la que se envían las métricas a StatsD. **Tipo:** `int` **Obligatorio**: sí  | 
| MaxPacketSize |  Tamaño máximo de paquete para las métricas, en bytes. Limita el tamaño de los paquetes UDP enviados a StatsD. **Tipo:** `int` **Obligatorio**: sí  | 

## ProcessParameters
<a name="integration-server-sdk-go-dataypes-process"></a>

Un objeto que describe la comunicación entre un proceso del servidor y Amazon GameLift Servers. El proceso del servidor proporciona esta información a Amazon GameLift Servers con una llamada a [ProcessReady()](integration-server-sdk-go-actions.md#integration-server-sdk-go-processready).


|  |  | 
| --- |--- |
|  **Propiedades**  | Descripción | 
| LogParameters | Un objeto con rutas de directorio a los archivos que se generan durante una sesión de juego. Amazon GameLift Servers copia y almacena los archivos para accesos futuros.**Tipo:** `LogParameters`**Obligatorio**: no | 
| OnHealthCheck | Nombre de la función de devolución de llamada que invoca Amazon GameLift Servers para solicitar un informe de estado del proceso del servidor. Amazon GameLift Servers llama a esta función cada 60 segundos y espera otros 60 segundos para obtener una respuesta. El proceso del servidor devuelve TRUE si está en buen estado y FALSE si no. Si no se devuelve ninguna respuesta, Amazon GameLift Servers registra el proceso del servidor como defectuoso.**Tipo:** `OnHealthCheck func() bool`**Obligatorio**: no | 
| OnProcessTerminate | La función de devolución de llamada que invoca Amazon GameLift Servers para forzar el cierre del proceso de servidor. Después de llamar a esta función, Amazon GameLift Servers espera 5 minutos hasta que el proceso del servidor se cierre y responde con una llamada a [ProcessEnding()](integration-server-sdk-go-actions.md#integration-server-sdk-go-processending) antes de cerrar el proceso del servidor.**Tipo:** `OnProcessTerminate func()`**Obligatorio**: sí | 
| OnStartGameSession | Nombre de la función de devolución de llamada que invoca Amazon GameLift Servers para proporcionar un objeto de sesión de juego actualizado. Amazon GameLift Servers llama a esta función una vez que se ha procesado una solicitud de reposición de emparejamiento para proporcionar datos actualizados del emparejador. Pasa un objeto [GameSession](#integration-server-sdk-go-dataypes-gamesession), una actualización de estado (updateReason) y el ID del ticket de reposición de emparejamiento.**Tipo:** `OnStartGameSession func (model.GameSession )`**Obligatorio**: sí | 
| OnUpdateGameSession | Función de devolución de llamada que invoca Amazon GameLift Servers para pasar la información de sesión de juego actualizada al proceso del servidor. Amazon GameLift Servers llama a esta función una vez que se ha procesado una solicitud de reposición de emparejamiento para proporcionar datos actualizados del emparejador. **Tipo:** `OnUpdateGameSession func (model.UpdateGameSession)`**Obligatorio**: no | 
| Port | El número de puerto en el que escucha el proceso del servidor para recibir conexiones de jugador nuevas. El valor debe estar en el rango de puertos configurado para cualquier flota que implemente esa compilación de servidor de juegos. Este número de puerto se incluye en los objetos de sesión de juego y de jugador, que las sesiones de juego utilizan a la hora de conectarse a un proceso del servidor.**Tipo:** `int`**Obligatorio**: sí | 

## UpdateGameSession
<a name="integration-server-sdk-go-dataypes-updategamesession"></a>

Las actualizaciones en un objeto de sesión de juego, que incluye el motivo por el que se actualizó la sesión de juego y el ID del ticket de reposición correspondiente si la reposición se utiliza para reponer las sesiones de los jugadores en la sesión de juego.


| Propiedades | **Descripción** | 
| --- | --- | 
| GameSession | Un objeto [GameSession](#integration-server-sdk-go-dataypes-gamesession). El objeto GameSession contiene propiedades que describen una sesión de juego. **Tipo:** `GameSession GameSession()`**Obligatorio**: sí | 
| UpdateReason | El motivo por el que se actualiza la sesión de juego.**Tipo:** `UpdateReason UpdateReason()`**Obligatorio**: sí | 
| BackfillTicketId | El ID de ticket de reposición que intenta actualizar la sesión de juego.**Tipo:** `String`**Obligatorio**: no | 

## GameSession
<a name="integration-server-sdk-go-dataypes-gamesession"></a>

Los detalles de una sesión de juego. 


| Propiedades | **Descripción** | 
| --- | --- | 
| GameSessionId |  Un identificador único de la sesión de juego. Un nombre de recurso de Amazon (ARN) de sesión de juego tiene el siguiente formato: `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>`. **Tipo:** `String` **Obligatorio**: no  | 
| Name |  Una etiqueta descriptiva de la sesión de juego.  **Tipo:** `String` **Obligatorio**: no  | 
| FleetId |  Un identificador único para la flota en la que se ejecuta la sesión de juego. **Tipo:** `String` **Obligatorio**: no  | 
| MaximumPlayerSessionCount |  El número máximo de conexiones de jugadores a la sesión de juego. **Tipo:** `Integer` **Obligatorio**: no  | 
| Puerto |  El número de puerto de la sesión de juego. Para conectarse a un servidor de Amazon GameLift Servers juegos, una aplicación necesita tanto la dirección IP como el número de puerto. **Tipo:** `Integer` **Obligatorio**: no  | 
| IpAddress |  La dirección IP del servidor de la sesión de juego. Para conectarse a un servidor de Amazon GameLift Servers juegos, la aplicación necesita tanto la dirección IP como el número de puerto. **Tipo:** `String` **Obligatorio**: no  | 
| GameSessionData |  Un conjunto de propiedades de sesión de juego personalizadas, formateadas como un valor de una sola cadena.  **Tipo:** `String` **Obligatorio**: no  | 
| MatchmakerData |  La información sobre el proceso de emparejamiento que se utilizó para crear la sesión de juego, en sintaxis JSON, con formato como cadena. Además de la configuración de emparejamiento utilizada, contiene datos sobre todos los jugadores asignados al emparejamiento, incluidos los atributos de los jugadores y las asignaciones de los equipos. **Tipo:** `String` **Obligatorio**: no  | 
| GameProperties |  Un conjunto de propiedades personalizadas de una sesión de juego, con formato como pares clave-valor. Estas propiedades se pasan a una solicitud de iniciar una nueva sesión de juego. **Tipo:** `map[string] string` **Obligatorio**: no  | 
| DnsName |  El identificador de DNS asignado a la instancia que ejecuta la sesión de juego. Los valores tienen formato siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/gameliftservers/latest/developerguide/integration-server-sdk-go-datatypes.html) Cuando se conecte a una sesión de juego que se ejecute en una flota habilitada de TLS, debe utilizar el nombre de DNS, no la dirección IP. **Tipo:** `String` **Obligatorio**: no  | 

## ServerParameters
<a name="integration-server-sdk-go-dataypes-serverparameters"></a>

La información utilizada para mantener la conexión entre un servidor de Amazon GameLift Servers Anywhere y el servicio Amazon GameLift Servers. Esta información se utiliza al inicializar nuevos procesos de servidor con [InitSDK()](integration-server-sdk-go-actions.md#integration-server-sdk-go-initsdk). Para los servidores alojados en instancias de EC2 administradas por Amazon GameLift Servers, utilice un objeto vacío.


| Propiedades | **Descripción** | 
| --- | --- | 
| WebSocketURL |  `GameLiftServerSdkEndpoint` que devuelve Amazon GameLift Servers cuando se invoca [https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html) para un recurso de computación de Amazon GameLift Servers Anywhere. **Tipo:** `string` **Obligatorio**: sí  | 
| ProcessID |  Un identificador único registrado en el proceso del servidor que aloja el juego. **Tipo:** `string` **Obligatorio**: sí  | 
| HostID |  El identificador único del recurso informático que aloja el nuevo proceso del servidor.  El `HostID` es el `ComputeName` utilizado cuando registró el recurso informático. Para obtener más información, consulte [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html). **Tipo:** `string` **Obligatorio**: sí  | 
| FleetID | El identificador único de la flota en la que está registrado el recurso informático. Para obtener más información, consulte [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**Tipo:** `string`**Obligatorio**: sí | 
| AuthToken | El token de autenticación generado por Amazon GameLift Servers que autentica el servidor en Amazon GameLift Servers. Para obtener más información, consulte [GetComputeAuthToken](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html).**Tipo:** `string`**Obligatorio**: sí | 

## StartMatchBackfillRequest
<a name="integration-server-sdk-go-dataypes-startmatchbackfillrequest"></a>

Información utilizada para crear una solicitud de reposición de emparejamiento. El servidor de juegos comunica esa información a Amazon GameLift Servers en una llamada a [StartMatchBackfill()](integration-server-sdk-go-actions.md#integration-server-sdk-go-startmatchbackfill).


| Propiedades | **Descripción** | 
| --- | --- | 
| GameSessionArn |  El identificador único de la sesión de juego. El `[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk-go-actions.html#integration-server-sdk-go-getgamesessionid)` de la operación de la API devuelve el identificador en formato de ARN. **Tipo:** `String` **Obligatorio**: sí  | 
| MatchmakingConfigurationArn |  El identificador único, en forma de ARN, que el emparejador utiliza para esta solicitud. El ARN del emparejador para la sesión de juego original se encuentra en el objeto de sesión de juego en la propiedad de datos del emparejador. Para obtener más información sobre los datos del emparejador, consulte [Trabajo con datos del emparejador](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html). **Tipo:** `String` **Obligatorio**: sí  | 
| Players |  Un conjunto de datos que representa a todos los jugadores que están actualmente en la sesión de juego. El creador de emparejamientos utiliza esta información para buscar nuevos jugadores que son idóneos para los jugadores actuales. **Tipo:** `[]model.Player` **Obligatorio**: sí  | 
| TicketId |  El identificador único para un ticket de solicitud de emparejamiento o reposición de emparejamiento. Si no proporciona un valor, Amazon GameLift Servers generará uno. Use este identificador para realizar un seguimiento del estado del ticket de reposición de emparejamiento o cancelar la solicitud si es necesario.  **Tipo:** `String` **Obligatorio**: no  | 

## Jugador
<a name="integration-server-sdk-go-dataypes-player"></a>

El objeto que representa a un jugador en el emparejamiento. Al iniciar una solicitud de emparejamiento, un jugador tiene un ID de jugador, atributos y, posiblemente, datos de latencia. Amazon GameLift Servers añade la información de los equipos tras realizar un emparejamiento.


| Propiedades | **Descripción** | 
| --- | --- | 
| LatencyInMS |  Un conjunto de valores expresados en milisegundos que indican la cantidad de latencia que experimenta un jugador cuando se conecta a una ubicación.  Si se utiliza esta propiedad, el jugador solo se empareja con las ubicaciones que aparecen. Si un creador de emparejamientos tiene una regla que evalúa la latencia de los jugadores, estos deben informar de la latencia para ser emparejados. **Tipo:** `map[string] int` **Obligatorio**: no  | 
| PlayerAttributes |  Una colección de pares de clave-valor que contienen información del jugador para su uso en el emparejamiento. Las claves de atributos del jugador deben coincidir con las PlayerAttributes utilizadas en un conjunto de reglas de emparejamiento. Para obtener más información sobre los atributos de los jugadores, consulte [AttributeValue](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html). **Tipo:** `map[string] AttributeValue` **Obligatorio**: no  | 
| PlayerId |  Un identificador único de un jugador. **Tipo:** `String` **Obligatorio**: no  | 
| Equipo |  El nombre del equipo al que está asignado el jugador en un emparejamiento. Defina el nombre del equipo se define en el conjunto de reglas de emparejamiento. **Tipo:** `String` **Obligatorio**: no  | 

## DescribePlayerSessionsRequest
<a name="integration-server-sdk-go-dataypes-playersessions"></a>

Un objeto que especifica las sesiones de jugador que recuperar. El proceso del servidor proporciona esta información con una llamada [DescribePlayerSessions()](integration-server-sdk-go-actions.md#integration-server-sdk-go-describeplayersessions) a Amazon GameLift Servers.


| Propiedades | **Descripción** | 
| --- | --- | 
| GameSessionID |  Un identificador único de la sesión de juegos. Use este parámetro para solicitar todas las sesiones de jugador de la sesión de juego especificada.  El formato de ID de sesión de juego es `arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>`. El `GameSessionID` es una cadena de ID personalizada o una cadena generada.  **Tipo:** `String` **Obligatorio**: no  | 
| PlayerSessionID |  El identificador único de una sesión de jugador. Utilice este parámetro para solicitar una sesión de jugador específica. **Tipo:** `String` **Obligatorio**: no  | 
| PlayerID |  El identificador único de un jugador. Utilice este parámetro para solicitar todas las sesiones de jugador para un jugador específico. Consulte [Generación de ID de jugador](player-sessions-player-identifiers.md). **Tipo:** `String` **Obligatorio**: no  | 
| PlayerSessionStatusFilter |  El estado de la sesión de jugador para filtrar los resultados. Los posibles estados de sesión de jugador son los siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/gameliftservers/latest/developerguide/integration-server-sdk-go-datatypes.html) **Tipo:** `String` **Obligatorio**: no  | 
| NextToken |  El token que indica el inicio de la siguiente página de resultados. Para especificar el inicio del conjunto de resultados, no indique ningún valor. Si se especifica un ID de sesión de jugador, este parámetro se ignora. **Tipo:** `String` **Obligatorio**: no  | 
| Limit |  El número máximo de resultados que devolver. Si se especifica un ID de sesión de jugador, este parámetro se ignora. **Tipo:** `int` **Obligatorio**: no  | 

## StopMatchBackfillRequest
<a name="integration-server-sdk-go-dataypes-stopmatchbackfillrequest"></a>

Información utilizada para cancelar una solicitud de reposición de emparejamiento. El servidor de juegos comunica esa información al servicio Amazon GameLift Servers en una llamada a [StopMatchBackfill()](integration-server-sdk-go-actions.md#integration-server-sdk-go-stopmatchbackfill).


| Propiedades | **Descripción** | 
| --- | --- | 
| GameSessionArn |  El identificador único de sesión de juego de la solicitud que se va a cancelar. **Tipo:** `string` **Obligatorio**: no  | 
| MatchmakingConfigurationArn |  El identificador único del emparejador al que se envió esta solicitud. **Tipo:** `string` **Obligatorio**: no  | 
| TicketId |  El identificador único del ticket de solicitud de reposición que se va a cancelar. **Tipo:** `string` **Obligatorio**: no  | 

## GetFleetRoleCredentialsRequest
<a name="integration-server-sdk-go-dataypes-getfleetrolecredentialsrequest"></a>

Las credenciales de rol que amplían el acceso limitado a tus AWS recursos al servidor del juego. Para obtener más información, consulte, [Configuración de un rol de servicio de IAM para Amazon GameLift Servers](setting-up-role.md).


| Propiedades | **Descripción** | 
| --- | --- | 
| RoleArn | El ARN del rol de servicio que amplía el acceso limitado a sus recursos de AWS .**Tipo:** `string`**Obligatorio**: sí | 
| RoleSessionName | El nombre de la sesión que describe el uso de las credenciales del rol.**Tipo:** `string`**Obligatorio**: sí | 

[SDK del servidor de Go para Amazon GameLift Servers: tipos de datos](integration-server-sdk-go-datatypes.md)

**Topics**
+ [SDK del servidor de Go para Amazon GameLift Servers: tipos de datos](integration-server-sdk-go-datatypes.md)
+ [GetSdkVersion()](#integration-server-sdk-go-getsdkversion)
+ [InitMetrics()](#integration-server-sdk-go-initmetrics)
+ [InitMetricsFromEnvironment()](#integration-server-sdk-go-initmetricsfromenv)
+ [InitSDK()](#integration-server-sdk-go-initsdk)
+ [ProcessReady()](#integration-server-sdk-go-processready)
+ [ProcessEnding()](#integration-server-sdk-go-processending)
+ [ActivateGameSession()](#integration-server-sdk-go-activategamesession)
+ [UpdatePlayerSessionCreationPolicy()](#integration-server-sdk-go-updateplayersessioncreationpolicy)
+ [GetGameSessionId()](#integration-server-sdk-go-getgamesessionid)
+ [GetTerminationTime()](#integration-server-sdk-go-getterm)
+ [AcceptPlayerSession()](#integration-server-sdk-go-acceptplayersession)
+ [RemovePlayerSession()](#integration-server-sdk-go-removeplayersession)
+ [DescribePlayerSessions()](#integration-server-sdk-go-describeplayersessions)
+ [StartMatchBackfill()](#integration-server-sdk-go-startmatchbackfill)
+ [StopMatchBackfill()](#integration-server-sdk-go-stopmatchbackfill)
+ [GetComputeCertificate()](#integration-server-sdk-go-getcomputecertificate)
+ [GetFleetRoleCredentials()](#integration-server-sdk-go-getfleetrolecredentials)
+ [Destroy()](#integration-server-sdk-go-destroy)

## GetSdkVersion()
<a name="integration-server-sdk-go-getsdkversion"></a>

Devuelve el número de versión actual del SDK integrado en el proceso del servidor.

### Sintaxis
<a name="integration-server-sdk-go-getsdkversion-syntax"></a>

```
func GetSdkVersion() (string, error)
```

### Valor devuelto
<a name="integration-server-sdk-go-getsdkversion-return"></a>

Si funciona correctamente, devuelve la versión del SDK actual como una cadena. La cadena devuelta solo incluye el número de versión (por ejemplo, `5.0.0`). Si no funciona, devuelve un mensaje de error, como `common.SdkVersionDetectionFailed`.

### Ejemplo
<a name="integration-server-sdk-go-getsdkversion-example"></a>

```
version, err := server.GetSdkVersion()
```

## InitMetrics()
<a name="integration-server-sdk-go-initmetrics"></a>

Inicializa la recopilación de métricas para el SDK de Amazon GameLift Servers. Este método configura los informes de métricas para ayudar a supervisar el rendimiento y el estado de los servidores. Llame a este método después de [InitSDK()](#integration-server-sdk-go-initsdk), pero antes de [ProcessReady()](#integration-server-sdk-go-processready).

### Sintaxis
<a name="integration-server-sdk-go-initmetrics-syntax"></a>

```
func InitMetrics() error
func InitMetrics(metricsParameters MetricsParameters) error
```

### Parameters
<a name="integration-server-sdk-go-initmetrics-parameter"></a>

MetricsParameters (opcional)  
Objeto `MetricsParameters` que configura la recopilación de métricas. Si no se proporciona, se utiliza la configuración de métricas predeterminada. La MetricsParameters estructura contiene los siguientes campos:  
+ `StatsdHost`: el nombre de host o dirección IP del servidor de StatsD.
+ `StatsdPort`: número de puerto del servidor de StatsD.
+ `CrashReporterHost`: nombre de host o dirección IP del servidor que notifica el bloqueo.
+ `CrashReporterPort`: número de puerto del servidor que notifica el bloqueo.
+ `FlushIntervalMs`: intervalo en milisegundos para vaciar los datos de las métricas al servidor.
+ `MaxPacketSize`: tamaño máximo de paquete para las métricas, en bytes.
Para obtener más información sobre la MetricsParameters estructura, consulte [Server SDK 5.x para los tipos de datos de C\$1](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk5-csharp-datatypes.html).

### Valor devuelto
<a name="integration-server-sdk-go-initmetrics-return"></a>

Si se realiza correctamente, devuelve un error `nil` para indicar que la recopilación de métricas se ha inicializado correctamente.

### Ejemplo
<a name="integration-server-sdk-go-initmetrics-example"></a>

Inicialización de las métricas con la configuración predeterminada:

```
err := server.InitMetrics()
```

Inicialización de las métricas con una configuración personalizada:

```
metricsParams := MetricsParameters{
    StatsdHost:        "localhost",
    StatsdPort:        8125,
    CrashReporterHost: "localhost",
    CrashReporterPort: 9125,
    FlushIntervalMs:   5000,
    MaxPacketSize:     1024,
}

err := server.InitMetrics(metricsParams)
```

## InitMetricsFromEnvironment()
<a name="integration-server-sdk-go-initmetricsfromenv"></a>

Inicializa la recopilación de métricas para el SDK de Amazon GameLift Servers utilizando la configuración de las variables de entorno. Este método configura los informes de métricas utilizando la configuración predeterminada derivada del entorno de tiempo de ejecución.

Llame a este método después de [InitSDK()](#integration-server-sdk-go-initsdk), pero antes de [ProcessReady()](#integration-server-sdk-go-processready).

### Sintaxis
<a name="integration-server-sdk-go-initmetricsfromenv-syntax"></a>

```
func InitMetricsFromEnvironment() error
```

### Valor devuelto
<a name="integration-server-sdk-go-initmetricsfromenv-return"></a>

Si se realiza correctamente, devuelve un error `nil` para indicar que la recopilación de métricas se ha inicializado correctamente con la configuración del entorno.

### Ejemplo
<a name="integration-server-sdk-go-initmetricsfromenv-example"></a>

```
err := server.InitMetricsFromEnvironment()
```

## InitSDK()
<a name="integration-server-sdk-go-initsdk"></a>

Inicializa el SDK de Amazon GameLift Servers. Llame a este método en el lanzamiento, antes de cualquier otra inicialización relacionada con Amazon GameLift Servers. Este método establece la comunicación entre el servidor y el servicio Amazon GameLift Servers.

### Sintaxis
<a name="integration-server-sdk-go-initsdk-syntax"></a>

```
func InitSDK(params ServerParameters) error 
```

### Parameters
<a name="integration-server-sdk-go-initsdk-parameter"></a>

[ServerParameters](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-serverparameters)  
Para inicializar un servidor de juegos en una flota de Amazon GameLift Servers Anywhere, cree un objeto `ServerParameters` con la siguiente información:  
+ La URL WebSocket utilizada para conectarse al servidor de juegos. 
+ El ID del proceso utilizado para alojar su servidor de juegos. 
+ El ID del proceso utilizado para alojar los procesos del servidor de juegos. 
+ El ID de la flota de Amazon GameLift Servers que contiene su recurso de computación de Amazon GameLift Servers Anywhere.
+ El token de autorización generado por la operación de Amazon GameLift Servers. 
Para inicializar un servidor de juegos en una flota de EC2 administrada de Amazon GameLift Servers, cree un objeto `ServerParameters` sin parámetros. Con esta llamada, el agente de Amazon GameLift Servers configura el entorno informático y se conecta automáticamente al servicio Amazon GameLift Servers por usted. 

### Valor devuelto
<a name="integration-server-sdk-go-initsdk-return"></a>

Si funciona correctamente, devuelve el error `nil` para indicar que el proceso del servidor está listo para llamar a [ProcessReady()](#integration-server-sdk-go-processready). 

**nota**  
Si las llamadas a `InitSDK()` no funcionan en las compilaciones de juegos implementadas en las flotas de Anywhere, compruebe el parámetro `ServerSdkVersion` que se utiliza al crear el recurso de compilación. Debe establecer este valor de forma explícita en la versión del SDK del servidor en uso. El valor predeterminado de este parámetro es 4.x, que no es compatible. Para resolver este problema, cree una compilación nueva e impleméntela en una flota nueva.

### Ejemplo
<a name="integration-server-sdk-go-initsdk-example"></a>

Ejemplo de Amazon GameLift Servers Anywhere

```
//Define the server parameters
serverParameters := ServerParameters {
  WebSocketURL: "wss://us-west-1.api.amazongamelift.com",
  ProcessID: "PID1234",
  HostID: "HardwareAnywhere",
  FleetID: "aarn:aws:gamelift:us-west-1:111122223333:fleet/fleet-9999ffff-88ee-77dd-66cc-5555bbbb44aa",
  AuthToken: "1111aaaa-22bb-33cc-44dd-5555eeee66ff"
}

//Call InitSDK to establish a local connection with the Amazon GameLift Servers Agent to enable further communication.
err := server.InitSDK(serverParameters)
```

Ejemplo de EC2 administrado por Amazon GameLift Servers

```
//Define the server parameters
serverParameters := ServerParameters {}

//Call InitSDK to establish a local connection with the Amazon GameLift Servers Agent to enable further communication.
err := server.InitSDK(serverParameters)
```

## ProcessReady()
<a name="integration-server-sdk-go-processready"></a>

Notifica a Amazon GameLift Servers que el proceso del servidor de juegos está listo para alojar sesiones de juego. Llame a este método después de invocar [InitSDK()](#integration-server-sdk-go-initsdk). Se debe llamar a este método solo una vez por proceso.

### Sintaxis
<a name="integration-server-sdk-go-processready-syntax"></a>

```
func ProcessReady(param ProcessParameters) error
```

### Parameters
<a name="integration-server-sdk-go-processready-parameter"></a>

**ProcessParameters**  
Es un objeto [ProcessParameters](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-process) que comunica la siguiente información sobre el proceso del servidor:  
+ Nombres de los métodos de devolución de llamada, implementados en el código de servidor de juegos, que el servicio Amazon GameLift Servers invoca para comunicarse con el proceso del servidor.
+ El número de puerto de escucha del servidor de proceso.
+ El tipo de datos [LogParameters](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-log) que contiene la ruta a cualquier archivo específico de la sesión de juego que desea que Amazon GameLift Servers capture y almacene.

### Valor devuelto
<a name="integration-server-sdk-go-processready-return"></a>

Devuelve un error con un mensaje de error si el método falla. Devuelve `nil` si el método se realiza correctamente.

### Ejemplo
<a name="integration-server-sdk-go-processready-example"></a>

Este ejemplo ilustra las implementaciones tanto de la función de llamada [ProcessReady()](#integration-server-sdk-go-processready) como de la función de delegación.

```
// Define the process parameters
processParams := ProcessParameters {
  OnStartGameSession: gameProcess.OnStartGameSession,
  OnUpdateGameSession: gameProcess.OnGameSessionUpdate,
  OnProcessTerminate: gameProcess.OnProcessTerminate,
  OnHealthCheck: gameProcess.OnHealthCheck,
  Port: port,
  LogParameters: LogParameters {    // logging and error example
    []string {"C:\\game\\logs", "C:\\game\\error"}
  }
}

err := server.ProcessReady(processParams)
```

## ProcessEnding()
<a name="integration-server-sdk-go-processending"></a>

Informa a Amazon GameLift Servers de que el proceso del servidor está finalizando. Llame a este método después de realizar todas las demás tareas de limpieza (lo que incluye el cierre de la sesión de juegos activa) y antes de finalizar el proceso. Según el resultado de `ProcessEnding()`, el proceso finaliza con éxito (0) o error (-1) y genera un evento de flota. Si el proceso finaliza con un error, el evento de flota generado será `SERVER_PROCESS_TERMINATED_UNHEALTHY`.

### Sintaxis
<a name="integration-server-sdk-go-processending-syntax"></a>

```
func ProcessEnding() error
```

### Valor devuelto
<a name="integration-server-sdk-go-processending-return"></a>

Devuelve un código de error 0 o un código de error definido.

### Ejemplo
<a name="integration-server-sdk-go-processending-example"></a>

```
// operations to end game sessions and the server process
defer func() {
  err := server.ProcessEnding()
  server.Destroy()
  if err != nil {
    fmt.Println("ProcessEnding() failed. Error: ", err)
    os.Exit(-1)
  } else {
    os.Exit(0)
  }
}
```

## ActivateGameSession()
<a name="integration-server-sdk-go-activategamesession"></a>

Notifica a Amazon GameLift Servers que el proceso del servidor ha iniciado una sesión de juego y que está listo para recibir las conexiones de los jugadores. Se llama a esta acción como parte de la función de devolución de llamada `onStartGameSession()`, después de la inicialización de todas las sesiones de juego.

### Sintaxis
<a name="integration-server-sdk-go-activategamesession-syntax"></a>

```
func ActivateGameSession() error
```

### Valor devuelto
<a name="integration-server-sdk-go-activategamesession-return"></a>

Devuelve un error con un mensaje de error si el método falla.

### Ejemplo
<a name="integration-server-sdk-go-activategamesession-example"></a>

Este ejemplo muestra cómo se llama a `ActivateGameSession()` como parte de la función de delegación `onStartGameSession()`. 

```
func OnStartGameSession(GameSession gameSession) {
  // game-specific tasks when starting a new game session, such as loading map   
  // Activate when ready to receive players   
  err := server.ActivateGameSession();
}
```

## UpdatePlayerSessionCreationPolicy()
<a name="integration-server-sdk-go-updateplayersessioncreationpolicy"></a>

Actualiza la capacidad de la sesión de juego actual para aceptar sesiones de jugador nuevas. Una sesión de juego se puede configurar para que acepte o deniegue todas las sesiones nuevas de los jugadores.

### Sintaxis
<a name="integration-server-sdk-go-updateplayersessioncreationpolicy-syntax"></a>

```
func UpdatePlayerSessionCreationPolicy(policy model.PlayerSessionCreationPolicy) error
```

### Parameters
<a name="integration-server-sdk-go-updateplayersessioncreationpolicy-parameter"></a>

**playerSessionCreationPolítica**  
Valor de cadena que indica si la sesión de juego acepta jugadores nuevos.   
Los valores válidos son:  
+ **`model.AcceptAll`**: se aceptan todas las sesiones de jugador nuevas.
+ **`model.DenyAll`**: se rechazan todas las sesiones de jugador nuevas.

### Valor devuelto
<a name="integration-server-sdk-go-updateplayersessioncreationpolicy-return"></a>

Devuelve un error con un mensaje de error si se produce un error.

### Ejemplo
<a name="integration-server-sdk-go-updateplayersessioncreationpolicy-example"></a>

Este ejemplo establece la política de participación en la sesión de juego actual para aceptar todos los jugadores.

```
err := server.UpdatePlayerSessionCreationPolicy(model.AcceptAll)
```

## GetGameSessionId()
<a name="integration-server-sdk-go-getgamesessionid"></a>

Recupera el ID de la sesión de juego alojada por el proceso del servidor.

### Sintaxis
<a name="integration-server-sdk-go-getgamesessionid-syntax"></a>

```
func GetGameSessionID() (string, error)
```

### Parameters
<a name="integration-server-sdk-go-getgamesessionid-parameter"></a>

Esta acción no tiene parámetros.

### Valor devuelto
<a name="integration-server-sdk-go-getgamesessionid-return"></a>

Si funciona correctamente, devuelve el ID de sesión del juego y el error nil. En el caso de los procesos inactivos que no se han activado aún con una sesión de juego, la llamada devuelve una cadena vacía y el error `nil`.

### Ejemplo
<a name="integration-server-sdk-go-getgamesessionid-example"></a>

```
gameSessionID, err := server.GetGameSessionID()
```

## GetTerminationTime()
<a name="integration-server-sdk-go-getterm"></a>

Devuelve la hora a la que está programada el cierre de un proceso de servidor, si hay una hora de terminación disponible. Un proceso del servidor realiza esta acción después de recibir una devolución de llamada `onProcessTerminate()` desde Amazon GameLift Servers. Amazon GameLift Servers llama a `onProcessTerminate()` por los motivos siguientes: 
+ Cuando el proceso del servidor ha informado de un mal estado o no ha respondido a Amazon GameLift Servers.
+ Al finalizar la instancia durante un evento de reducción vertical.
+ [Cuando se finaliza una instancia debido a la interrupción de una instancia de spot](spot-tasks.md).

### Sintaxis
<a name="integration-server-sdk-go-getterm-syntax"></a>

```
func GetTerminationTime() (int64, error)
```

### Valor devuelto
<a name="integration-server-sdk-go-getterm-return"></a>

Si se ejecuta correctamente, devuelve la marca temporal en segundos en la que está previsto que el proceso del servidor se cierre y finalice el error `nil`. El valor es la hora de terminación expresado en ciclos transcurridos desde `0001 00:00:00`. Por ejemplo, el valor de la fecha y hora `2020-09-13 12:26:40 -000Z` es igual a `637355968000000000` ciclos. Si no hay una hora de terminación disponible, devuelve un mensaje de error.

### Ejemplo
<a name="integration-server-sdk-go-getterm-example"></a>

```
terminationTime, err := server.GetTerminationTime()
```

## AcceptPlayerSession()
<a name="integration-server-sdk-go-acceptplayersession"></a>

Notifica a Amazon GameLift Servers que un jugador con el ID de sesión de jugador especificado se ha conectado al proceso del servidor y requiere validación. Amazon GameLift Servers verifica que el ID de sesión de jugador es válido. Una vez validada la sesión del jugador, Amazon GameLift Servers cambia el estado del espacio de jugador de `RESERVED` a `ACTIVE`. 

### Sintaxis
<a name="integration-server-sdk-go-acceptplayersession-syntax"></a>

```
func AcceptPlayerSession(playerSessionID string) error
```

### Parameters
<a name="integration-server-sdk-go-acceptplayersession-parameter"></a>

`playerSessionId`  
ID único emitido por Amazon GameLift Servers cuando se crea una nueva sesión de jugador.

### Valor devuelto
<a name="integration-server-sdk-go-acceptplayersession-return"></a>

Devuelve un resultado genérico correcto o erróneo con un mensaje de error. 

### Ejemplo
<a name="integration-server-sdk-go-acceptplayersession-example"></a>

Este ejemplo gestiona una solicitud de conexión que incluye la validación y el rechazo de una sesión de jugador no válida. IDs 

```
func ReceiveConnectingPlayerSessionID(conn Connection, playerSessionID string) {
    err := server.AcceptPlayerSession(playerSessionID)
    if err != nil {
        connection.Accept()
    } else {
        connection.Reject(err.Error())
    }
}
```

## RemovePlayerSession()
<a name="integration-server-sdk-go-removeplayersession"></a>

Informa a Amazon GameLift Servers de que un jugador se ha desconectado del proceso del servidor. Como respuesta, Amazon GameLift Servers cambia el espacio del jugador para que esté disponible. 

### Sintaxis
<a name="integration-server-sdk-go-removeplayersession-syntax"></a>

```
func RemovePlayerSession(playerSessionID string) error
```

### Parameters
<a name="integration-server-sdk-go-removeplayersession-parameter"></a>

**`playerSessionId`**  
ID único emitido por Amazon GameLift Servers cuando se crea una nueva sesión de jugador.

### Valor devuelto
<a name="integration-server-sdk-go-removeplayersession-return"></a>

Devuelve un resultado genérico correcto o erróneo con un mensaje de error.

### Ejemplo
<a name="integration-server-sdk-go-removeplayersession-example"></a>

```
err := server.RemovePlayerSession(playerSessionID)
```

## DescribePlayerSessions()
<a name="integration-server-sdk-go-describeplayersessions"></a>

Recupera datos de sesión de jugador, incluida la configuración, los metadatos de la sesión y los datos de jugador. Utilice este método para obtener información sobre los siguientes elementos:
+ Una sesión para un jugador
+ Todas las sesiones del jugador en una sesión de juego
+ Todas las sesiones de jugador están asociadas a un único ID de jugador

### Sintaxis
<a name="integration-server-sdk-go-describeplayersessions-syntax"></a>

```
func DescribePlayerSessions(req request.DescribePlayerSessionsRequest) (result.DescribePlayerSessionsResult, error) {
	return srv.describePlayerSessions(&req)
}
```

### Parameters
<a name="integration-server-sdk-go-describeplayersessions-parameter"></a>

**[DescribePlayerSessionsRequest](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-playersessions)**  
Es un objeto `DescribePlayerSessionsRequest` que describe las sesiones de jugador a recuperar.

### Valor devuelto
<a name="integration-server-sdk-go-describeplayersessions-return"></a>

Si funciona correctamente, devuelve un objeto `DescribePlayerSessionsResult` que contiene un conjunto de objetos de sesión de jugador que se ajusta a los parámetros de la solicitud.

### Ejemplo
<a name="integration-server-sdk-go-describeplayersessions-example"></a>

En este ejemplo se solicitan todas las sesiones de jugador conectadas activamente a una sesión de juego específica. Al omitir *NextToken*y establecer el valor *límite* en 10, Amazon GameLift Servers devuelve los registros de las sesiones de los primeros 10 jugadores que coincidan con la solicitud.

```
// create request
describePlayerSessionsRequest := request.NewDescribePlayerSessions() 
describePlayerSessionsRequest.GameSessionID, _ = server.GetGameSessionID() // get ID for the current game session
describePlayerSessionsRequest.Limit = 10                                 // return the first 10 player sessions
describePlayerSessionsRequest.PlayerSessionStatusFilter = "ACTIVE"         // Get all player sessions actively connected to the game session

describePlayerSessionsResult, err := server.DescribePlayerSessions(describePlayerSessionsRequest)
```

## StartMatchBackfill()
<a name="integration-server-sdk-go-startmatchbackfill"></a>

Envía una solicitud para encontrar nuevos jugadores para ranuras abiertas en una sesión de juego creada con FlexMatch. Para obtener más información, consulte [Característica de reposición de FlexMatch](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-backfill.html).

Esta acción es asíncrona. Si se emparejan nuevos jugadores, Amazon GameLift Servers ofrece datos actualizados del emparejador mediante la función de devolución de llamada `OnUpdateGameSession()`.

Un proceso del servidor solo puede tener una solicitud de reposición de emparejamiento activa a la vez. Para enviar una nueva solicitud, en primer lugar llame a [StopMatchBackfill()](#integration-server-sdk-go-stopmatchbackfill) para cancelar la solicitud original.

### Sintaxis
<a name="integration-server-sdk-go-startmatchbackfill-syntax"></a>

```
func StartMatchBackfill(req request.StartMatchBackfillRequest) (result.StartMatchBackfillResult, error)
```

### Parameters
<a name="integration-server-sdk-go-startmatchbackfill-parameter"></a>

**[StartMatchBackfillRequest](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-startmatchbackfillrequest)**  
Un StartMatchBackfillRequest objeto comunica la siguiente información:  
+ Un ID de ticket que se asignará a la solicitud de reposición. Esta información es opcional; si no se proporciona ningún ID, Amazon GameLift Servers genera uno.
+ El creador de emparejamientos al que se enviará la solicitud. El ARN de configuración completo es obligatorio. Este valor se encuentra en los datos del emparejador de la sesión de juego.
+ El ID de la sesión de juego que se va a reponer.
+ Datos del emparejador disponibles para los jugadores actuales de la sesión de juego.

### Valor devuelto
<a name="integration-server-sdk-go-startmatchbackfill-return"></a>

Devuelve un objeto `StartMatchBackfillResult` con el ID del ticket de reposición de emparejamiento o un error con un mensaje de error. 

### Ejemplo
<a name="integration-server-sdk-go-startmatchbackfill-example"></a>

```
// form the request
startBackfillRequest := request.NewStartMatchBackfill()
startBackfillRequest.RequestID = "1111aaaa-22bb-33cc-44dd-5555eeee66ff"          // optional
startBackfillRequest.MatchmakingConfigurationArn = "arn:aws:gamelift:us-west-2:111122223333:matchmakingconfiguration/MyMatchmakerConfig"
var matchMaker model.MatchmakerData
if err := matchMaker.UnmarshalJSON([]byte(gameSession.MatchmakerData)); err != nil {    
    return
}
startBackfillRequest.Players = matchMaker.Players
res, err := server.StartMatchBackfill(startBackfillRequest)

// Implement callback function for backfill
func OnUpdateGameSession(myGameSession model.GameSession) {
    // game-specific tasks to prepare for the newly matched players and update matchmaker data as needed
}
```

## StopMatchBackfill()
<a name="integration-server-sdk-go-stopmatchbackfill"></a>

Cancela una solicitud de reposición de emparejamiento activa. Para obtener más información, consulte [Característica de reposición de FlexMatch](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-backfill.html).

### Sintaxis
<a name="integration-server-sdk-go-stopmatchbackfill-syntax"></a>

```
func StopMatchBackfill(req request.StopMatchBackfillRequest) error
```

### Parameters
<a name="integration-server-sdk-go-stopmatchbackfill-parameter"></a>

**[StopMatchBackfillRequest](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-stopmatchbackfillrequest)**  
Un StopMatchBackfillRequest objeto que identifica el billete de emparejamiento que se va a cancelar:   
+ ID del ticket que se asignará a la solicitud de reposición
+ El emparejador al que se envió la solicitud de reposición
+ La sesión de juego asociada a la solicitud de reposición.

### Valor devuelto
<a name="integration-server-sdk-go-stopmatchbackfill-return"></a>

Devuelve un resultado genérico correcto o erróneo con un mensaje de error.

### Ejemplo
<a name="integration-server-sdk-go-stopmatchbackfill-example"></a>

```
stopBackfillRequest := request.NewStopMatchBackfill()  // Use this function to create request
stopBackfillRequest.TicketID = "1111aaaa-22bb-33cc-44dd-5555eeee66ff"
stopBackfillRequest.MatchmakingConfigurationArn = "arn:aws:gamelift:us-west-2:111122223333:matchmakingconfiguration/MyMatchmakerConfig"
                
//error
err := server.StopMatchBackfill(stopBackfillRequest)
```

## GetComputeCertificate()
<a name="integration-server-sdk-go-getcomputecertificate"></a>

Recupera la ruta al certificado TLS utilizado para cifrar la conexión de red entre el servidor de juegos y el cliente de juego. Puede utilizar la ruta del certificado al registrar el dispositivo informático en una flota de Amazon GameLift Servers Anywhere. Para obtener más información, consulte [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).

### Sintaxis
<a name="integration-server-sdk-go-getcomputecertificate-syntax"></a>

```
func GetComputeCertificate() (result.GetComputeCertificateResult, error)
```

### Valor devuelto
<a name="integration-server-sdk-go-getcomputecertificate-return"></a>

Devuelve un objeto `GetComputeCertificateResult` que contiene los siguientes elementos: 
+  CertificatePath: la ruta al certificado TLS de su recurso informático. Cuando se utiliza una flota administrada por Amazon GameLift Servers, la ruta contiene los siguientes elementos: 
  + `certificate.pem`: el certificado del usuario final. La cadena de certificados completa es la combinación del `certificateChain.pem` adjunto a este certificado.
  + `certificateChain.pem`: la cadena de certificados que contiene el certificado raíz y los certificados intermedios.
  + `rootCertificate.pem`: el certificado raíz.
  + `privateKey.pem`: la clave privada del certificado del usuario final.
+ ComputeName: el nombre del recurso informático.

### Ejemplo
<a name="integration-server-sdk-go-getcomputecertificate-example"></a>

```
tlsCertificate, err := server.GetFleetRoleCredentials(getFleetRoleCredentialsRequest)
```

## GetFleetRoleCredentials()
<a name="integration-server-sdk-go-getfleetrolecredentials"></a>

Recupera las credenciales de la función de servicio que has creado para extender los permisos a la otra Servicios de AWS . Amazon GameLift Servers Estas credenciales permiten que su servidor de juegos utilice sus recursos de AWS . Para obtener más información, consulte [Configuración de un rol de servicio de IAM para Amazon GameLift Servers](setting-up-role.md).

### Sintaxis
<a name="integration-server-sdk-go-getfleetrolecredentials-syntax"></a>

```
func GetFleetRoleCredentials(
  req request.GetFleetRoleCredentialsRequest,
) (result.GetFleetRoleCredentialsResult, error) {
  return srv.getFleetRoleCredentials(&req)
}
```

### Parameters
<a name="integration-server-sdk-go-getfleetrolecredentials-parameters"></a>

[GetFleetRoleCredentialsRequest](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-getfleetrolecredentialsrequest)  
Credenciales de rol que amplían el acceso limitado a tus AWS recursos al servidor del juego.

### Valor devuelto
<a name="integration-server-sdk-go-getfleetrolecredentials-return"></a>

Devuelve un objeto `GetFleetRoleCredentialsResult` que contiene los siguientes elementos: 
+ AssumedRoleUserArn - El nombre de recurso de Amazon (ARN) del usuario al que pertenece la función de servicio. 
+ AssumedRoleId - El ID del usuario al que pertenece el rol de servicio. 
+ AccessKeyId - El ID de la clave de acceso para autenticar y proporcionar acceso a sus AWS recursos. 
+ SecretAccessKey - El identificador de la clave de acceso secreta para la autenticación. 
+ SessionToken - Un token para identificar la sesión activa actual que interactúa con tus AWS recursos. 
+ Vencimiento: el tiempo que queda hasta que caduquen las credenciales de la sesión.

### Ejemplo
<a name="integration-server-sdk-go-getfleetrolecredentials-example"></a>

```
// form the customer credentials request
getFleetRoleCredentialsRequest := request.NewGetFleetRoleCredentials()
getFleetRoleCredentialsRequest.RoleArn = "arn:aws:iam::123456789012:role/service-role/exampleGameLiftAction"

credentials, err := server.GetFleetRoleCredentials(getFleetRoleCredentialsRequest)
```

## Destroy()
<a name="integration-server-sdk-go-destroy"></a>

Libera de la memoria el SDK del servidor de juegos de Amazon GameLift Servers. Como práctica recomendada, llame a este método después de `ProcessEnding()` y antes de finalizar el proceso. Si utiliza una flota de Anywhere y no va a finalizar los procesos del servidor después de cada sesión de juego, llame a `Destroy()` y, a continuación, a `InitSDK()` para reinicializar antes de informar a Amazon GameLift Servers de que el proceso está listo para organizar una sesión de juego con `ProcessReady()`.

### Sintaxis
<a name="integration-server-sdk-go-destroy-syntax"></a>

```
func Destroy() error {
	return srv.destroy()
}
```

### Valor devuelto
<a name="integration-server-sdk-go-destroy-return"></a>

Devuelve un error con un mensaje de error si el método falla.

### Ejemplo
<a name="integration-server-sdk-go-destroy-example"></a>

```
// operations to end game sessions and the server process
defer func() {
  err := server.ProcessEnding()
  server.Destroy()
  if err != nil {
    fmt.Println("ProcessEnding() failed. Error: ", err)
    os.Exit(-1)
  } else {
    os.Exit(0)
  }
}
```