As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# SDK do servidor do Go para Amazon GameLift Servers – ações
<a name="integration-server-sdk-go-actions"></a>

Use a referência do SDK 5.x do servidor para integrar o jogo multijogador à hospedagem com o Amazon GameLift Servers. Para obter orientação sobre o processo de integração, consulte [Integre o Amazon GameLift Servers ao seu servidor de jogos com o SDK do servidor.](gamelift-sdk-server-api.md).

`GameLiftServerAPI.go` define as ações do SDK do servidor Go.

# SDK do servidor Go para Amazon GameLift Servers -- Tipos de dados
<a name="integration-server-sdk-go-datatypes"></a>

Use a referência do SDK do servidor para integrar o jogo multijogador à hospedagem com o Amazon GameLift Servers. Para obter orientação sobre o processo de integração, consulte [Integre o Amazon GameLift Servers ao seu servidor de jogos com o SDK do servidor.](gamelift-sdk-server-api.md).

`GameLiftServerAPI.go` define as ações do SDK do servidor Go.

[SDK do servidor do Go para Amazon GameLift Servers – ações](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)
+ [

## Jogador
](#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>

Um objeto que identifica arquivos gerados durante uma sessão de jogo que você deseja que o Amazon GameLift Servers carregue e armazene após o término da sessão de jogo. O servidor do jogo fornece `LogParameters` ao Amazon GameLift Servers como parte de um objeto `ProcessParameters` em uma chamada [ProcessReady()](integration-server-sdk-go-actions.md#integration-server-sdk-go-processready).


|  |  | 
| --- |--- |
|  **Properties**  | Descrição | 
| LogPaths |  A lista de caminhos de diretório para arquivos de log do servidor de jogos que você deseja que o Amazon GameLift Servers armazene para acesso futuro. O processo do servidor gera esses arquivos durante cada sessão de jogo. Você define caminhos e nomes de arquivos em seu servidor de jogo e os armazena no diretório raiz de construção do jogo.  Os caminhos de log devem ser absolutos. Por exemplo, se a compilação do jogo armazenasse logs de sessão de jogo em um caminho como `MyGame\sessionLogs\`, o caminho estará em `c:\game\MyGame\sessionLogs` uma instância do Windows. **Digite**: `[]string` **Obrigatório**: não  | 

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

Um objeto comunicando parâmetros de configuração para inicializar o sistema de métricas. Essa configuração é usada para configurar relatórios do StatsD, relatórios de falhas e comportamento de processamento de métricas. O servidor do jogo fornece `MetricsParameters` ao Amazon GameLift Servers como parte de uma chamada [InitMetrics()](integration-server-sdk-go-actions.md#integration-server-sdk-go-initmetrics).


|  |  | 
| --- |--- |
|  **Properties**  | Descrição | 
| StatsdHost |  O host do servidor StatsD para relatórios de métricas (por exemplo, “localhost”). **Digite**: `string` **Obrigatório**: Sim  | 
| StatsdPort |  A porta do servidor StatsD para relatórios de métricas (por exemplo, 8125). **Digite**: `int` **Obrigatório**: Sim  | 
| CrashReporterHost |  O host do relatório de acidentes para rastreamento de falhas e monitoramento de processos. **Digite**: `string` **Obrigatório**: Sim  | 
| CrashReporterPort |  A porta do relatório de acidentes para rastreamento de falhas e monitoramento de processos. **Digite**: `int` **Obrigatório**: Sim  | 
| FlushIntervalMs |  O intervalo para limpar os dados das métricas em milissegundos. Controla a frequência com que as métricas são enviadas ao StatsD. **Digite**: `int` **Obrigatório**: Sim  | 
| MaxPacketSize |  O tamanho máximo dos pacotes para métricas em bytes. Limita o tamanho dos pacotes UDP enviados para o StatsD. **Digite**: `int` **Obrigatório**: Sim  | 

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

Um objeto que descreve a comunicação entre um processo de servidor e o Amazon GameLift Servers. O processo do servidor fornece essas informações ao Amazon GameLift Servers com uma chamada para [ProcessReady()](integration-server-sdk-go-actions.md#integration-server-sdk-go-processready).


|  |  | 
| --- |--- |
|  **Properties**  | Descrição | 
| LogParameters | Um objeto com caminhos de diretório para arquivos que são gerados durante uma sessão de jogo. O Amazon GameLift Servers copia e armazena para acessos futuros.**Digite**: `LogParameters`**Obrigatório**: não | 
| OnHealthCheck | A função de retorno de chamada que o Amazon GameLift Servers invoca para solicitar um relatório de status de integridade do processo de servidor. O Amazon GameLift Servers chama essa função a cada 60 segundos e espera 60 segundos por uma resposta. O processo do servidor retorna TRUE se estiver íntegro, FALSE se não estiver íntegro. Se nenhuma resposta for retornada, o Amazon GameLift Servers registra o processo do servidor como não íntegro.**Digite**: `OnHealthCheck func() bool`**Obrigatório**: não | 
| OnProcessTerminate | A função de retorno de chamada que o Amazon GameLift Servers invoca para forçar o encerramento do processo do servidor. Depois de chamar essa função, o Amazon GameLift Servers aguardará 5 minutos para o processo de servidor desligar e responder com uma chamada [ProcessEnding()](integration-server-sdk-go-actions.md#integration-server-sdk-go-processending) antes do desligamento do processo de servidor.**Digite**: `OnProcessTerminate func()`**Obrigatório**: Sim | 
| OnStartGameSession | O nome da função de retorno de chamada que o Amazon GameLift Servers invoca para passar um objeto de sessão de jogo atualizado ao processo do jogo. O Amazon GameLift Servers chama essa função quando uma solicitação de alocação de correspondência foi processada para fornecer dados de combinador atualizados. Ele transmite um objeto [GameSession](#integration-server-sdk-go-dataypes-gamesession), uma atualização de status (updateReason) e o ID do tíquete de alocação de correspondência.**Digite**: `OnStartGameSession func (model.GameSession )`**Obrigatório**: Sim | 
| OnUpdateGameSession | O nome da função de retorno de chamada que o Amazon GameLift Servers invoca para passar informações de sessão de jogo atualizadas ao processo do jogo. O Amazon GameLift Servers chama essa função após processar uma solicitação de alocação de correspondência para fornecer dados de combinador atualizados. **Digite**: `OnUpdateGameSession func (model.UpdateGameSession)`**Obrigatório**: não | 
| Port | O número da porta em que o processo de servidor escuta para novas conexões de jogador. O valor deve estar dentro do intervalo de portas configurado para qualquer frota que implanta essa compilação do servidor de jogo. Esse número de porta está incluído nos objetos das sessões de jogo e jogador, que as sessões de jogo usam ao se conectar a um processo de servidor.**Digite**: `int`**Obrigatório**: Sim | 

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

As atualizações em um objeto de sessão de jogo, que incluem o motivo pelo qual a sessão de jogo foi atualizada e o ID do tíquete de alocação relacionado, caso o preenchimento esteja sendo usado para preencher sessões de jogadores na sessão de jogo.


| Propriedades | **Descrição** | 
| --- | --- | 
| GameSession | Um objeto [GameSession](#integration-server-sdk-go-dataypes-gamesession). O objeto GameSession contém propriedades que descrevem uma sessão de jogo. **Digite**: `GameSession GameSession()`**Obrigatório**: Sim | 
| UpdateReason | O motivo pelo qual a sessão do jogo está sendo atualizada.**Digite**: `UpdateReason UpdateReason()`**Obrigatório**: Sim | 
| BackfillTicketId | O ID do tíquete de alocação que está tentando atualizar a sessão do jogo.**Digite**: `String`**Obrigatório**: não | 

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

Os detalhes de uma sessão de jogo. 


| Propriedades | **Descrição** | 
| --- | --- | 
| GameSessionId |  Um identificador exclusivo da sessão de jogo. Um nome do recurso da Amazon (ARN) de sessão de jogo tem o seguinte formato: `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>`. **Digite**: `String` **Obrigatório**: não  | 
| Nome |  Um rótulo descritivo da sessão do jogo.  **Digite**: `String` **Obrigatório**: não  | 
| FleetId |  Um identificador exclusivo da frota em que a sessão de jogo está sendo executada. **Digite**: `String` **Obrigatório**: não  | 
| MaximumPlayerSessionCount |  O número máximo de conexões do jogador com a sessão do jogo. **Digite**: `Integer` **Obrigatório**: não  | 
| Porta |  O número da porta da sessão de jogo. Para se conectar a um servidor de Amazon GameLift Servers jogos, um aplicativo precisa do endereço IP e do número da porta. **Digite**: `Integer` **Obrigatório**: não  | 
| IpAddress |  O endereço IP da sessão de jogo. Para se conectar a um servidor de Amazon GameLift Servers jogos, um aplicativo precisa do endereço IP e do número da porta. **Digite**: `String` **Obrigatório**: não  | 
| GameSessionData |  Um conjunto de propriedades de sessão de jogo personalizadas, formatadas como um único valor de string.  **Digite**: `String` **Obrigatório**: não  | 
| MatchmakerData |  As informações sobre o processo de criação de partidas usado para criar a sessão do jogo, na sintaxe JSON, formatado como uma string. Além da configuração de criação de partidas usada, ele contém dados sobre todos os jogadores atribuídos à partida, incluindo atributos do jogador e atribuições da equipe. **Digite**: `String` **Obrigatório**: não  | 
| GameProperties |  Um conjunto de propriedades personalizadas para uma sessão de jogo, formatado como pares de chave:valor. Essas propriedades são passadas com uma solicitação de início de uma nova sessão de jogo. **Digite**: `map[string] string` **Obrigatório**: não  | 
| DnsName |  O identificador DNS atribuído à instância que está executando a sessão do jogo. Os valores têm o formato a seguir: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/gameliftservers/latest/developerguide/integration-server-sdk-go-datatypes.html) Ao se conectar a uma sessão de jogo que está sendo executada em uma frota compatível com TLS, você deve usar o nome DNS, não o endereço IP. **Digite**: `String` **Obrigatório**: não  | 

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

Informações usadas para manter a conexão entre um servidor Amazon GameLift Servers Anywhere o serviço do Amazon GameLift Servers. Essas informações são usadas ao iniciar novos processos de servidor com [InitSDK()](integration-server-sdk-go-actions.md#integration-server-sdk-go-initsdk). Para servidores hospedados em instâncias EC2 gerenciadas pelo Amazon GameLift Servers, use um objeto vazio.


| Propriedades | **Descrição** | 
| --- | --- | 
| WebSocketURL |  Os retornos `GameLiftServerSdkEndpoint` Amazon GameLift Servers quando você [https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html) para um recurso de computação Amazon GameLift Servers Anywhere. **Digite**: `string` **Obrigatório**: Sim  | 
| ProcessID |  Um identificador exclusivo registrado no processo do servidor que hospeda seu jogo. **Digite**: `string` **Obrigatório**: Sim  | 
| HostID |  O identificador exclusivo do recurso de computação que está hospedando o novo processo de servidor.  O `HostID` é o `ComputeName` usado quando você registrou seu computador. Para obter mais informações, consulte [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html). **Digite**: `string` **Obrigatório**: Sim  | 
| FleetID | O identificador exclusivo da frota na qual o computador está registrado. Para obter mais informações, consulte [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**Digite**: `string`**Obrigatório**: Sim | 
| AuthToken | O token de autenticação gerado pelo Amazon GameLift Servers que autentica seu servidor no Amazon GameLift Servers. Para obter mais informações, consulte [GetComputeAuthToken](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html).**Digite**: `string`**Obrigatório**: Sim | 

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

Informações usadas para criar uma solicitação de alocação de criação de partidas. O servidor do jogo comunica essas informações ao Amazon GameLift Servers em uma chamada [StartMatchBackfill()](integration-server-sdk-go-actions.md#integration-server-sdk-go-startmatchbackfill).


| Propriedades | **Descrição** | 
| --- | --- | 
| GameSessionArn |  O identificador da sessão de jogo exclusivo. A operação de API retorna `[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk-go-actions.html#integration-server-sdk-go-getgamesessionid)` o identificador no formato de ARN. **Digite**: `String` **Obrigatório**: Sim  | 
| MatchmakingConfigurationArn |  O identificador exclusivo (na forma de um ARN), para o marcador de jogos a ser usado para essa solicitação. O marcador de jogos da ARN da sessão de jogo original está no objeto de sessão de jogo, na propriedade de dados do marcador de jogos. Para obter mais informações sobre dados de matchmaker, consulte [Trabalhar com dados de marcador de jogos](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html). **Digite**: `String` **Obrigatório**: Sim  | 
| Jogadores |  Um conjunto de dados que representa todos os jogadores que estão na sessão do jogo no momento. O marcador de jogos usa essas informações para pesquisar novos jogadores que sejam correspondências ideais para os jogadores atuais. **Digite**: `[]model.Player` **Obrigatório**: Sim  | 
| TicketId |  O identificador exclusivo de um tíquete de solicitação de marcação de jogo ou de alocação de correspondência. Se você não fornecer um valor, o Amazon GameLift Servers gerará um. Use esse identificador para acompanhar o status do tíquete de alocação de correspondência ou cancelar a solicitação, se necessário.  **Digite**: `String` **Obrigatório**: não  | 

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

O objeto que representa um jogador em criação de partidas. Quando uma solicitação de criação de partidas começa, um jogador tem um ID de jogador, atributos, e possivelmente dados de latência. O Amazon GameLift Servers adiciona as informações de equipe após uma combinação ter sido feita.


| Propriedades | **Descrição** | 
| --- | --- | 
| LatencyInMS |  Um conjunto de valores expressos em milissegundos que indicam a quantidade de latência que um jogador experimenta quando conectado a um local.  Se essa propriedade for usada, o player só será correspondido aos locais listados. Se um marcador de jogos tiver uma regra que avalie a latência do jogador, os jogadores deverão reportar a latência a ser correspondida. **Digite**: `map[string] int` **Obrigatório**: não  | 
| PlayerAttributes |  Uma coleção de pares de chave:valor que contêm informações de jogadores para uso em criação de partidas. As chaves de atributos do jogador devem corresponder às PlayerAttributes usadas em um conjunto de regras de matchmaking. Para obter mais informações sobre os atributos do jogador, consulte [AttributeValue](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html). **Digite**: `map[string] AttributeValue` **Obrigatório**: não  | 
| PlayerId |  Um identificador exclusivo para um jogador. **Digite**: `String` **Obrigatório**: não  | 
| Equipe |  O nome da equipe à qual o jogador está designado em uma partida. Você define o nome da equipe no conjunto de regras de criação de partidas. **Digite**: `String` **Obrigatório**: não  | 

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

Um objeto que especifica quais sessões de jogador devem ser recuperadas. O processo do servidor fornece essas informações com uma chamada [DescribePlayerSessions()](integration-server-sdk-go-actions.md#integration-server-sdk-go-describeplayersessions) para o Amazon GameLift Servers.


| Propriedades | **Descrição** | 
| --- | --- | 
| GameSessionID |  Um identificador da sessão de jogo exclusivo. Use esse parâmetro para solicitar todas as sessões de jogador da sessão de jogo especificada.  O formato do ID da sessão do jogo é `arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>`. O `GameSessionID` é uma string de ID personalizada ou uma string gerada.  **Digite**: `String` **Obrigatório**: não  | 
| PlayerSessionID |  Um identificador exclusivo para uma sessão de jogador. Use esse parâmetro para solicitar uma única sessão de jogador específica. **Digite**: `String` **Obrigatório**: não  | 
| PlayerID |  Um identificador exclusivo para um jogador. Use este parâmetro para solicitar todas as sessões de jogador para um jogador específico. Consulte [Gerar IDs de jogador](player-sessions-player-identifiers.md). **Digite**: `String` **Obrigatório**: não  | 
| PlayerSessionStatusFilter |  O status da sessão de jogador para filtrar resultados. Entre os status da sessão de jogador possíveis incluem: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/gameliftservers/latest/developerguide/integration-server-sdk-go-datatypes.html) **Digite**: `String` **Obrigatório**: não  | 
| NextToken |  O token que indica o início da próxima página de resultados. Para especificar o início do conjunto de resultados, não forneça um valor. Se fornecer um ID de sessão do jogador, esse parâmetro será ignorado. **Digite**: `String` **Obrigatório**: não  | 
| Limit |  O número máximo de resultados a serem retornados. Se fornecer um ID de sessão do jogador, esse parâmetro será ignorado. **Digite**: `int` **Obrigatório**: não  | 

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

Informações usadas para cancelar uma solicitação de alocação de criação de partidas. O servidor do jogo comunica essas informações ao serviço Amazon GameLift Servers em uma chamada [StopMatchBackfill()](integration-server-sdk-go-actions.md#integration-server-sdk-go-stopmatchbackfill).


| Propriedades | **Descrição** | 
| --- | --- | 
| GameSessionArn |  O identificador de sessão de jogo exclusivo da solicitação que está sendo cancelada. **Digite**: `string` **Obrigatório**: não  | 
| MatchmakingConfigurationArn |  O identificador exclusivo do marcador de jogos para o qual essa solicitação foi enviada. **Digite**: `string` **Obrigatório**: não  | 
| TicketId |  O identificador exclusivo do tíquete de solicitação de alocação a ser cancelado. **Digite**: `string` **Obrigatório**: não  | 

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

As credenciais da função que estendem o acesso limitado aos seus AWS recursos no servidor do jogo. Para obter mais informações, consulte, [Configurar um perfil de serviço do IAM para o Amazon GameLift Servers](setting-up-role.md).


| Propriedades | **Descrição** | 
| --- | --- | 
| RoleArn | O ARN do perfil de serviço que estende o acesso limitado aos seus recursos AWS .**Digite**: `string`**Obrigatório**: Sim | 
| RoleSessionName | O nome da sessão que descreve o uso das credenciais da função.**Digite**: `string`**Obrigatório**: Sim | 

[SDK do servidor Go para Amazon GameLift Servers -- Tipos de dados](integration-server-sdk-go-datatypes.md)

**Topics**
+ [

# SDK do servidor Go para Amazon GameLift Servers -- Tipos de dados
](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>

Retorna o número da versão atual do SDK compilado no processo de servidor.

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

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

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

Se bem-sucedido, retornará a versão do SDK como uma sequência. A string retornada inclui o número da versão (exemplo, `5.0.0`). Se não for bem-sucedido, retornará uma mensagem de erro como `common.SdkVersionDetectionFailed`.

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

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

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

Inicializa a coleta de métricas para o Amazon GameLift Servers SDK. Esse método configura relatórios de métricas para ajudar a monitorar o desempenho e a integridade do servidor. Chame esse método depois do [InitSDK()](#integration-server-sdk-go-initsdk), mas antes do [ProcessReady()](#integration-server-sdk-go-processready).

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

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

### Parâmetros
<a name="integration-server-sdk-go-initmetrics-parameter"></a>

MetricsParameters (opcional)  
Um objeto `MetricsParameters` que configura a coleta de métricas. Se não for fornecida, a configuração padrão de métricas será usada. A MetricsParameters estrutura contém os seguintes campos:  
+ `StatsdHost` - O nome do host ou endereço IP do servidor do StatsD.
+ `StatsdPort` - O número da porta do servidor StatsD.
+ `CrashReporterHost` - O endereço IP ou o nome do host do serviço de relatório de falhas.
+ `CrashReporterPort` - O número da porta do serviço de relatório de falhas.
+ `FlushIntervalMs` - O intervalo em milissegundos para limpar os dados das métricas.
+ `MaxPacketSize` - O tamanho máximo dos pacotes de métricas em bytes.
Para obter mais informações sobre a MetricsParameters estrutura, consulte [Server SDK 5.x para tipos de dados C\$1](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk5-csharp-datatypes.html).

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

Se for bem-sucedido, retornará um erro `nil` para indicar que a coleta de métricas foi inicializada com sucesso.

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

Inicialize as métricas com a configuração padrão:

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

Inicialize as métricas com a configuração 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 a coleta de métricas para o Amazon GameLift Servers SDK usando a configuração de variáveis de ambiente. Esse método configura relatórios de métricas usando configurações padrão derivadas do ambiente de runtime.

Chame esse método depois do [InitSDK()](#integration-server-sdk-go-initsdk), mas antes do [ProcessReady()](#integration-server-sdk-go-processready).

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

```
func InitMetricsFromEnvironment() error
```

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

Se for bem-sucedido, retornará um erro `nil` para indicar que a coleta de métricas foi inicializada com sucesso utilizando a configuração do ambiente.

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

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

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

Inicializa o Amazon GameLift Servers SDK. Chame esse método na inicialização, antes que qualquer outra inicialização relacionada ao Amazon GameLift Servers ocorra. Esse método configura a comunicação entre o servidor e o serviço do Amazon GameLift Servers.

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

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

### Parâmetros
<a name="integration-server-sdk-go-initsdk-parameter"></a>

[ServerParameters](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-serverparameters)  
Para inicializar um servidor de jogos em uma frota do Amazon GameLift Servers Anywhere, construa um objeto `ServerParameters` com as seguintes informações:  
+ O URL do WebSocket usado para se conectar ao seu servidor de jogo. 
+ O ID do processo usado para hospedar o servidor de jogos. 
+ O ID do computador que hospeda os processos do seu servidor de jogos. 
+ O ID da frota do Amazon GameLift Servers que contém sua computação Amazon GameLift Servers Anywhere.
+ O token de autorização gerado pela operação do Amazon GameLift Servers. 
Para inicializar um servidor de jogo em uma frota EC2 gerenciada pelo Amazon GameLift Servers, construa um objeto `ServerParameters` sem parâmetros. Com essa chamada, o atendente do Amazon GameLift Servers configura o ambiente computacional e se conecta automaticamente ao serviço do Amazon GameLift Servers para você. 

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

Se for bem-sucedido, retornará um erro `nil` para indicar que o processo do servidor está pronto para ser chamado [ProcessReady()](#integration-server-sdk-go-processready). 

**nota**  
Se as chamadas para `InitSDK()` estiverem falhando para compilações de jogos implantadas em frotas do Anywhere, verifique o parâmetro `ServerSdkVersion` usado ao criar o recurso de compilação. Você deve definir explicitamente esse valor para a versão do SDK do servidor em uso. O valor padrão desse parâmetro é 4.x, o que não é compatível. Para resolver esse problema, crie uma nova versão e implante-a em uma nova frota.

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

Exemplo 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)
```

Exemplo de EC2 gerenciado pelo 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 o Amazon GameLift Servers de que o processo do servidor está pronto para hospedar sessões do jogo. Chame esse método após invocar [InitSDK()](#integration-server-sdk-go-initsdk). Esse método deve ser chamado apenas uma vez por processo.

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

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

### Parâmetros
<a name="integration-server-sdk-go-processready-parameter"></a>

**ProcessParameters**  
Um objeto [ProcessParameters](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-process) transmite as seguintes informações sobre o processo do servidor:  
+ Os nomes de métodos de retorno de chamada, implementados no código do servidor de jogos, que o serviço Amazon GameLift Servers invoca para se comunicar com o processo de servidor.
+ O número da porta em que o processo de servidor está escutando.
+ O tipo de dados de [LogParameters](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-log), contém o caminho para qualquer arquivo específico da sessão de jogo que você deseja que o Amazon GameLift Servers capture e armazene.

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

Retorna um erro com uma mensagem de erro se o método falhar. Se o método for bem-sucedido, ele retornará `nil`.

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

Este exemplo ilustra as implementações das funções de chamada e delegação [ProcessReady()](#integration-server-sdk-go-processready).

```
// 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>

Notifica o Amazon GameLift Servers de que o processo do servidor está sendo encerrado. Chame esse método depois de todas as outras tarefas de limpeza (incluindo o encerramento da sessão ativa do jogo) e antes de encerrar o processo. Dependendo do resultado `ProcessEnding()`, o processo sai com sucesso (0) ou erro (-1) e gera um evento de frota. Se o processo for encerrado com um erro, o evento de frota gerado será `SERVER_PROCESS_TERMINATED_UNHEALTHY`.

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

```
func ProcessEnding() error
```

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

Retorna um código de erro 0 ou um código de erro definido.

### Exemplo
<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 o Amazon GameLift Servers de que o processo do servidor ativou uma sessão do jogo e já está pronto para receber as conexões do jogador. Essa ação é chamada como parte da função de retorno de chamada `onStartGameSession()`, após toda a inicialização da sessão do jogo.

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

```
func ActivateGameSession() error
```

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

Retorna um erro com uma mensagem de erro se o método falhar.

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

Este exemplo mostra chamado `ActivateGameSession()` como parte da função de delegação `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>

Atualiza a capacidade da sessão do jogo atual para aceitar novas sessões de jogador. Atualiza a capacidade da sessão do jogo atual para aceitar novas sessões de jogador.

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

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

### Parâmetros
<a name="integration-server-sdk-go-updateplayersessioncreationpolicy-parameter"></a>

**playerSessionCreationPolítica**  
Valor de string que indica se a sessão do jogo aceita novos jogadores.   
Os valores válidos são:  
+ **`model.AcceptAll`** – Aceite todas as novas sessões de jogador.
+ **`model.DenyAll`** – Recuse todas as novas sessões de jogador.

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

Retorna um erro com uma mensagem de erro se ocorrer uma falha.

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

Este exemplo define a política de ingresso da sessão do jogo atual para aceitar todos os jogadores.

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

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

Recupera o ID da sessão de jogo hospedada pelo processo do servidor ativo.

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

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

### Parâmetros
<a name="integration-server-sdk-go-getgamesessionid-parameter"></a>

Essa ação não tem um parâmetro.

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

Se bem-sucedido, retornará o ID da sessão de jogo e nenhum erro. Para processos inativos que ainda não foram ativados com uma sessão de jogo, a chamada retorna uma string vazia e um erro `nil`.

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

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

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

Retorna a hora em que um processo do servidor está programado para ser desligado se essa informação estiver disponível. Um processo do servidor realiza essa ação depois de receber um retorno de chamada `onProcessTerminate()` do serviço Amazon GameLift Servers. O Amazon GameLift Servers chama o `onProcessTerminate()` pelos seguintes motivos: 
+ Quando o processo do servidor relatou problemas de saúde ou não respondeu ao Amazon GameLift Servers.
+ Ao encerrar a instância durante um evento de redução.
+ Quando uma instância é encerrada devido a uma [interrupção na instância spot](spot-tasks.md).

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

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

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

Se for bem-sucedido, retornará o registro de data e hora em segundos em que o processo do servidor está programado para ser encerrado e um erro `nil` de encerramento. O valor é o tempo de rescisão, expresso em tiques decorridos de `0001 00:00:00`. Por exemplo, o valor da data e hora `2020-09-13 12:26:40 -000Z` é igual aos tiques `637355968000000000`. Se nenhum horário de rescisão estiver disponível, o retornará uma mensagem de erro.

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

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

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

Notifica o serviço Amazon GameLift Servers de que um jogador com o ID da sessão do jogador especificado se conectou ao processo do servidor e precisa de validação. O Amazon GameLift Servers confirma que o ID da sessão do jogador é válido. Depois que a sessão do jogador é validada, o Amazon GameLift Servers altera o status do slot do jogador de `RESERVED` para `ACTIVE`. 

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

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

### Parâmetros
<a name="integration-server-sdk-go-acceptplayersession-parameter"></a>

`playerSessionId`  
ID exclusivo emitido pela Amazon GameLift Servers quando uma nova sessão de jogador é criada.

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

Retorna um resultado genérico que consiste em sucesso ou falha com uma mensagem de erro. 

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

Este exemplo trata de uma solicitação de conexão que inclui a validação e a rejeição de uma sessão de jogador invá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>

Notifica o Amazon GameLift Servers de que um jogador se desconectou do processo do servidor. Em resposta, o Amazon GameLift Servers altera o espaço do jogador para disponível. 

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

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

### Parâmetros
<a name="integration-server-sdk-go-removeplayersession-parameter"></a>

**`playerSessionId`**  
ID exclusivo emitido pela Amazon GameLift Servers quando uma nova sessão de jogador é criada.

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

Retorna um resultado genérico que consiste em sucesso ou falha com uma mensagem de erro.

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

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

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

Recupera dados da sessão do jogador, que incluem configurações, metadados da sessão e dados do jogador. Use esse método para obter informações sobre o seguinte:
+ Uma sessão para um jogador
+ Todas as sessões de jogador em uma sessão de jogo
+ Todas as sessões de jogadores associadas a um único ID de jogador

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

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

### Parâmetros
<a name="integration-server-sdk-go-describeplayersessions-parameter"></a>

**[DescribePlayerSessionsRequest](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-playersessions)**  
Um objeto `DescribePlayerSessionsRequest` descreve quais sessões de jogador recuperar.

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

Se bem-sucedido, retorna um objeto `DescribePlayerSessionsResult` que contém um conjunto de objetos de sessão do jogador que atendem aos parâmetros de solicitação.

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

Este exemplo solicita todas as sessões de jogador conectadas ativamente a uma sessão de jogo especificada. Ao omitir *NextToken*e definir o valor *limite* como 10, Amazon GameLift Servers retorna os primeiros registros de sessão de 10 jogadores que correspondam à solicitação.

```
// 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>

Envia uma solicitação para encontrar novos jogadores para os slots abertos em uma sessão de jogo criada com o FlexMatch. Para obter mais informações, consulte o [recurso de alocação do FlexMatch](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-backfill.html).

Esta ação é assíncrona. Se novos jogadores forem combinados, o Amazon GameLift Servers entregará os dados atualizados do marcador de jogos usando a função de retorno de chamada `OnUpdateGameSession()`.

Um processo de servidor pode ter apenas uma solicitação de alocação de correspondência ativa por vez. Para enviar uma nova solicitação, primeiro chame [StopMatchBackfill()](#integration-server-sdk-go-stopmatchbackfill) para cancelar a solicitação original.

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

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

### Parâmetros
<a name="integration-server-sdk-go-startmatchbackfill-parameter"></a>

**[StartMatchBackfillRequest](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-startmatchbackfillrequest)**  
Um StartMatchBackfillRequest objeto comunica as seguintes informações:  
+ ID do tíquete a ser atribuído à solicitação de alocação. Essas informações são opcionais; se nenhum ID for fornecido, o Amazon GameLift Servers gerará um.
+ O marcador de jogos para o qual a solicitação é enviada. O ARN completo da configuração é necessário. Esse valor está nos dados do marcador de jogos da sessão de jogo.
+ O ID da sessão de jogo a ser preenchida.
+ Os dados disponíveis de marcação para os jogadores atuais da sessão do jogo.

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

Retorna um objeto `StartMatchBackfillResult` com o ID do tíquete de alocação de correspondência ou um falha com uma mensagem de erro. 

### Exemplo
<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 uma solicitação de alocação de correspondência ativa. Para obter mais informações, consulte o [recurso de alocação do FlexMatch](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-backfill.html).

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

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

### Parâmetros
<a name="integration-server-sdk-go-stopmatchbackfill-parameter"></a>

**[StopMatchBackfillRequest](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-stopmatchbackfillrequest)**  
Um StopMatchBackfillRequest objeto que identifica o tíquete de matchmaking a ser cancelado:   
+ O ID do ticket atribuído à solicitação de alocação.
+ O marcador de jogo que recebeu a solicitação de alocação.
+ A sessão do jogo associada à solicitação de alocação.

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

Retorna um resultado genérico que consiste em sucesso ou falha com uma mensagem de erro.

### Exemplo
<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 o caminho para o certificado TLS usado para criptografar a conexão de rede entre o servidor do jogo e o cliente do jogo. Você poderá usar o caminho do certificado ao registrar seu dispositivo computacional em uma frota do Amazon GameLift Servers Anywhere. Para obter mais informações, consulte [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).

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

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

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

Retorna um objeto `GetComputeCertificateResult` que contém o seguinte: 
+  CertificatePath: o caminho para o certificado TLS em seu recurso computacional. Ao usar uma frota gerenciada do Amazon GameLift Servers, esse caminho contém: 
  + `certificate.pem`: o certificado do usuário final. A cadeia completa de certificados é a combinação de `certificateChain.pem` anexados a esse certificado.
  + `certificateChain.pem`: a cadeia de certificados que contém o certificado raiz e os certificados intermediários.
  + `rootCertificate.pem`: o certificado raiz.
  + `privateKey.pem`: a chave privada para o certificado do usuário final.
+ ComputeName: o nome do seu recurso computacional.

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

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

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

Recupera as credenciais da função de serviço que você cria para estender as permissões à sua outra Serviços da AWS pessoa. Amazon GameLift Servers Essas credenciais permitem que seu servidor de jogo use seus recursos AWS . Para obter mais informações, consulte [Configurar um perfil de serviço do IAM para o Amazon GameLift Servers](setting-up-role.md).

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

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

### Parâmetros
<a name="integration-server-sdk-go-getfleetrolecredentials-parameters"></a>

[GetFleetRoleCredentialsRequest](integration-server-sdk-go-datatypes.md#integration-server-sdk-go-dataypes-getfleetrolecredentialsrequest)  
Credenciais de função que ampliam o acesso limitado aos seus AWS recursos no servidor do jogo.

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

Retorna um objeto `GetFleetRoleCredentialsResult` que contém o seguinte: 
+ AssumedRoleUserArn - O Amazon Resource Name (ARN) do usuário ao qual a função de serviço pertence. 
+ AssumedRoleId - O ID do usuário ao qual a função de serviço pertence. 
+ AccessKeyId - O ID da chave de acesso para autenticar e fornecer acesso aos seus AWS recursos. 
+ SecretAccessKey - O ID da chave de acesso secreta para autenticação. 
+ SessionToken - Um token para identificar a sessão ativa atual interagindo com seus AWS recursos. 
+ Expiração – A quantidade de tempo até que suas credenciais de sessão expirem.

### Exemplo
<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 o SDK do servidor de jogos do Amazon GameLift Servers da memória. Como melhor prática, chame esse método antes `ProcessEnding()` e depois de encerrar o processo. Se você estiver usando uma frota Anywhere e não estiver encerrando os processos do servidor após cada sessão de jogo, chame `Destroy()` e reinicialize `InitSDK()` antes de notificar o Amazon GameLift Servers de que o processo está pronto para hospedar uma sessão de jogo com `ProcessReady()`.

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

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

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

Retorna um erro com uma mensagem de erro se o método falhar.

### Exemplo
<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)
  }
}
```