Todos os produtos
Search
Central de documentação

:Instalação

Última atualização: Sep 24, 2026

O OSS SDK for Go permite que você gerencie recursos no Object Storage Service (OSS) de forma programática. Por exemplo, gerencie buckets, faça upload de objetos, baixe objetos e processe imagens. Este tópico descreve as etapas para que você instale o OSS SDK for Go.

Preparação do ambiente

  • Requisitos do ambiente

    Recomenda-se a versão 1.13 ou superior do OSS SDK for Go.

    Para obter mais informações, baixe e instale o ambiente para o OSS SDK for Go e acesse instale o Go a partir do código-fonte.

    • Se você utilizar o OSS SDK for Go 1.13 ou superior, o modo de módulo é habilitado por padrão para gerenciar as dependências de pacotes. Você não precisa especificar manualmente a variável de sistema GOPATH.

    • Se você utilizar o OSS SDK for Go 1.12 ou anterior, especifique a variável de sistema GOPATH e aponte-a para o seu diretório de código. Para obter mais informações sobre a variável de sistema GOPATH, execute o comando go help gopath.

  • Verifique a versão do OSS SDK for Go

    Execute o comando go version e visualize a versão do Go.

Baixe o OSS SDK for Go

Instale o OSS SDK for Go

Go mod

Adicione as seguintes dependências ao arquivo go.mod. No exemplo a seguir, utiliza-se a versão 3.0.2 do OSS SDK for Go. Caso utilize outra versão, substitua pelo número da sua versão.

require (
    github.com/aliyun/aliyun-oss-go-sdk v3.0.2+incompatible
)

Código-fonte

go get github.com/aliyun/aliyun-oss-go-sdk/oss
Nota

O sistema não exibe mensagens durante a instalação. O processo de instalação leva alguns minutos para ser concluído. Se a instalação falhar, execute o comando anterior novamente.

Verifique se o OSS SDK for Go está instalado

Execute o código a seguir para consultar a versão do OSS SDK for Go:

package main

import (
  "fmt"
  "github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
  fmt.Println("OSS Go SDK Version: ", oss.Version)
}
            

Próximos passos

Após instalar o OSS SDK for Go, configure as credenciais de acesso. Para obter mais informações, consulte Configure access credentials (Go SDK V1).