Todos os produtos
Search
Central de documentação

:Instalação

Última atualização: Jul 03, 2026

O OSS SDK for Go permite gerenciar recursos no Object Storage Service (OSS) programaticamente. Por exemplo, você pode gerenciar buckets, fazer upload e baixe de objetos e processar imagens. Este tópico descreve como instale o OSS SDK for Go.

Preparação do ambiente

  • Requisitos do ambiente

    Recomendamos o uso do OSS SDK for Go 1.13 ou posterior.

    Para obter mais informações sobre como baixe e instale o ambiente para o OSS SDK for Go, acesse Installing Go from source.

    • Se você usar o OSS SDK for Go 1.13 ou posterior, o modo de módulo será ativado por padrão para gerencie dependências de pacotes. Não é necessário especifique manualmente a variável de sistema GOPATH.

    • Se você usar o OSS SDK for Go 1.12 ou anterior, especifique a variável de sistema GOPATH e aponte-a para o diretório do seu 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 para 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. O exemplo a seguir usa o OSS SDK for Go 3.0.2. Se você usar outra versão, substitua pelo número da versão correspondente.

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

Source code

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

Nenhuma mensagem é exibida durante a instalação. O processo 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 instale o OSS SDK for Go, configure as credenciais de acesso. Para obter mais informações, consulte Configurar credenciais de acesso (Go SDK V1).