Serviço de metadados de instância do Amazon EC2

Você pode usar o AWS SDK para Go para acessar o Serviço de metadados de instância do Amazon EC2. O pacote feature/ec2/imds do Go fornece um tipo de Cliente que pode ser usado para acessar o serviço de metadados de instância do Amazon EC2. As operações de Client e associadas podem ser usadas de forma semelhante aos outros clientes de serviço da AWS fornecidos pelo SDK. Consulte mais informações sobre como configurar o SDK e usar clientes de serviço em Configurar o SDK e Usar o AWS SDK para Go v2 com serviços da AWS.

O cliente pode ajudar a recuperar facilmente informações sobre instâncias nas quais as aplicações são executadas, como a região da AWS ou endereço IP local. Normalmente, você precisa criar e enviar solicitações HTTP para recuperar os metadados da instância. Em vez disso, crie um imds.Client para acessar o serviço de metadados de instância do Amazon EC2 usando um cliente programático como outros serviços da AWS.

Por exemplo, para construir um cliente:

import "context"
import "github.com/aws/aws-sdk-go-v2/config"
import "github.com/aws/aws-sdk-go-v2/feature/ec2/imds"

// ...

cfg, err := config.LoadDefaultConfig(context.TODO())
if err != nil {
    log.Printf("error: %v", err)
    return
}

client := imds.NewFromConfig(cfg)

Então, use o cliente de serviço para recuperar informações de uma categoria de metadados, como local-ipv4 (o endereço IP privado da instância).

localIp, err := client.GetMetadata(context.TODO(), &imds.GetMetadataInput{
    Path: "local-ipv4",
})
if err != nil {
    log.Printf("Unable to retrieve the private IP address from the EC2 instance: %s\n", err)
    return
}
content, _ := io.ReadAll(localIp.Content)
fmt.Printf("local-ip: %v\n", string(content))

Consulte uma lista de todas as categorias de metadados em Categorias de metadados de instância no Guia do usuário do Amazon EC2.