Central de documentação

Todos os produtos

Central de documentação

:Instalação

Última atualização: Oct 10, 2026

Para gerenciar buckets do Object Storage Service (OSS), fazer upload e baixe objetos, gerenciar dados e realizar processamento de imagens (IMG), instale primeiro o OSS SDK for Python. Este tópico descreve como instalar o OSS SDK for Python.

Preparativos

Instale o Python.

O OSS SDK for Python requer as versões 2,6, 2,7, 3,3, 3,4, 3,5, 3,6, 3,7, 3,8 ou superior do Python.

Nota
Ao instalar o OSS SDK for Python no Windows, verifique se a versão do Visual C++ é 15,0 ou superior.
Execute o comando a seguir para verificar a versão do Python:
```
 pip install --upgrade oss2
```
A resposta a seguir indica que o Python 3.8.2 está instalado:
```
 pip install --upgrade oss2
```

Baixe o OSS SDK for Python

 pip install --upgrade oss2

Instalar python-devel

Após preparar o ambiente, instale o pacote python-devel.

Nota

O OSS SDK for Python utiliza a biblioteca crcmod para calcular o valor da verificação de redundância cíclica (CRC). Essa biblioteca depende do arquivo Python.h presente no pacote python-devel. Se o arquivo Python.h não existir, a instalação não será afetada, mas as extensões em C do crcmod não serão instaladas. Nesse caso, o modo somente Python é usado para calcular o valor de CRC e executar o CRC-64 durante o upload e baixe objetos. Consequentemente, operações como upload e baixe objetos são executadas com baixa eficiência.

Windows

Ao instalar o Python no Windows, o arquivo Python.h é instalado junto com o Python. Portanto, não é necessário instalar o python-devel.

macOS

Ao instalar o Python no macOS, o arquivo Python.h é instalado junto com o Python. Portanto, não é necessário instalar o python-devel.

CentOS

Execute o comando a seguir para instalar o python-devel:

 pip install --upgrade oss2

RHEL

Execute o comando a seguir para instalar o python-devel:

 pip install --upgrade oss2

Fedora

Execute o comando a seguir para instalar o python-devel:

 pip install --upgrade oss2

Debian

Execute o comando a seguir para instalar o python-devel:

 pip install --upgrade oss2

Ubuntu

Execute o comando a seguir para instalar o python-devel:

 pip install --upgrade oss2

Instale o OSS SDK for Python

Após instalar o python-devel, utilize um dos métodos a seguir para instalar o OSS SDK for Python:

pip

Instale o pip.

O pip já vem instalado por padrão no Python 2.7.9 ou superior e no Python 3.4 ou superior.
Execute o comando a seguir para instalar a versão mais recente do OSS SDK for Python:
```
 pip install --upgrade oss2
```

Código-fonte

Acesse o GitHub para baixe o pacote da versão mais recente do OSS SDK for Python. Descompacte o pacote e verifique se o arquivo setup.py existe no diretório.

Para obter mais informações sobre como baixe uma versão anterior do OSS SDK for Python, consulte Versões históricas.
Execute o comando a seguir para instalar o OSS SDK for Python:
```
 pip install --upgrade oss2
```

Verifique se o OSS SDK for Python está instalado

Após a instalação do OSS SDK for Python, siga as etapas abaixo para verificar se ele foi instalado corretamente:

Execute o comando a seguir para insira no ambiente Python:
```
 pip install --upgrade oss2
```
Execute o comando a seguir para verificar a versão do OSS SDK for Python:
```
 pip install --upgrade oss2
```
A resposta a seguir indica que o OSS SDK for Python 2.18.3 está instalado.
```
 pip install --upgrade oss2
```

Perguntas frequentes

O que fazer se a mensagem de erro "No module named _crcfunext" for retornada?

Descrição do problema

O uso do OSS SDK for Python para chamar operações de upload e baixe é muito mais lento do que o uso de outras ferramentas, como ossutil ou outros SDKs do OSS.

Causas

Durante a compilação da biblioteca crcmod, o arquivo _crcfunext.so depende do arquivo Python.h. O erro ocorre porque o arquivo Python.h não existe no sistema, o que impede a geração do arquivo _crcfunext.so. Para obter mais informações sobre o crcmod, consulte Introdução ao crcmod.

Soluções

Siga as etapas abaixo para verificar se as extensões em C do crcmod estão instaladas:

Execute o comando a seguir para insira no ambiente Python:
```
 pip install --upgrade oss2
```
Execute o comando a seguir para importar o módulo de extensão C do _crcfunext no módulo crcmod:
```
 pip install --upgrade oss2
```
Se a mensagem de erro a seguir aparecer, significa que as extensões em C do crcmod não foram instaladas:
```
 pip install --upgrade oss2
```
Escolha uma solução de acordo com seu sistema operacional:
Windows
1. Baixe o crcmod-1.7.win32-py2.7.msi ou um arquivo .msi de outra versão.
  
  Nota
  A biblioteca crcmod para sistemas win32 também é compatível com sistemas win64.
2. Instale o arquivo .msi e especifique o diretório Lib\site-packages no caminho de instalação local do Python como o caminho de instalação do crcmod. Exemplo: D:\python\Lib\site-packages\.
3. Repita as etapas anteriores para verificar se as extensões em C do crcmod foram instaladas após a instalação do arquivo .msi.
Linux

No Linux, siga as etapas abaixo para resolver o problema:
1. Execute o comando a seguir para desinstalar a biblioteca crcmod:
```
 pip install --upgrade oss2
```
2. Instale o python-devel. Para obter mais informações, consulte Install python-devel.
3. Execute o comando a seguir para reinstalar a biblioteca crcmod:
```
 pip install --upgrade oss2
```
  Se a instalação da biblioteca crcmod falhar após a execução das etapas anteriores, desinstale-a. Em seguida, execute o comando a seguir para visualize os detalhes da falha de instalação:
```
 pip install --upgrade oss2
```

O que fazer se a mensagem de erro No module named 'Crypto' for retornada?

Descrição do problema

A mensagem de erro No module named 'Crypto' é retornada durante a execução do programa.

Causas

Não existe Crypto ou existe crypto.

Soluções

Verifique se o Crypto existe no caminho de instalação local do Python, como D:\python3.9\Lib\site-packages.

Caso o Crypto não exista, execute o comando a seguir:
```
 pip install --upgrade oss2
```
Se existir crypto com a primeira letra minúscula, altere a primeira letra para maiúscula e reinicie o programa.

O que fazer se uma mensagem de erro indicar que o comando não é um comando interno ou externo?

No Windows, caso receba uma mensagem de erro indicando que o comando não é reconhecido como interno ou externo, modifique a variável de ambiente Path e adicione os caminhos de instalação do Python e do pip à variável. O caminho de instalação do pip corresponde ao diretório Scripts dentro do caminho de instalação do Python. Após modificar a variável de ambiente Path, talvez seja necessário reiniciar o computador para que as alterações tenham efeito.

O que fazer se a instalação do OSS SDK for Python falhar?

Se a instalação do OSS SDK for Python falhar, execute o comando a seguir para desinstalá-lo. Em seguida, reinstale-o.

 pip install --upgrade oss2

Como atualizar o OSS SDK for Python?

Execute o comando a seguir para atualizar o OSS SDK for Python:

 pip install --upgrade oss2