GitHub | Guia do desenvolvedor do OSS Go SDK V2 | API do OSS SDK for Go
Guia de início rápido
Preparação do ambiente
Requer o Go 1.18 ou superior.
Verifique a sua versão do Go com go -version . Se o Go não estiver instalado ou for anterior à versão 1.18, instale o Go .
Instalar o SDK
-
Crie um diretório para o projeto e inicialize o módulo do Go.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Instale o pacote do SDK (recomenda-se a versão mais recente).
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Importe o pacote do SDK.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Configurar credenciais de acesso
Utilize o AccessKey de um usuário do RAM para configurar as credenciais de acesso.
No RAM console, crie um usuário do RAM com Access By Using Permanent AccessKey, salve o par de AccessKey e conceda a permissão
AliyunOSSFullAccess.-
Use o AccessKey do usuário do RAM para configurar as variáveis de ambiente.
Linux
-
Adicione as variáveis de ambiente ao arquivo
~/.bashrc.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.-
Aplique as alterações.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Verifique se as variáveis de ambiente foram definidas.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
-
macOS
-
Verifique o seu shell padrão.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.-
Configure as variáveis de ambiente com base no seu shell.
Zsh
-
Adicione as variáveis de ambiente ao arquivo
~/.zshrc.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Aplique as alterações.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Verifique se as variáveis de ambiente foram definidas.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Bash
-
Adicione as variáveis de ambiente ao arquivo
~/.bash_profile.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Aplique as alterações.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Verifique se as variáveis de ambiente foram definidas.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
-
-
Windows
CMD
-
Execute os seguintes comandos no CMD.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.-
Verifique se as variáveis de ambiente foram definidas.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
-
PowerShell
-
Execute os seguintes comandos no PowerShell.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.-
Verifique se as variáveis de ambiente foram definidas.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
-
-
Inicializar o cliente
Devido a uma alteração de política para melhorar a conformidade e a segurança, a partir de 20 de março de 2025, novos usuários do OSS devem {{XREF_0}} (CNAME) para executar operações de API de dados em buckets do OSS localizados em regiões da China continental. Os endpoints públicos padrão são restritos para essas operações. Consulte o anúncio oficial para obter uma lista completa das operações afetadas. Se você acessar seus dados via HTTPS, deverá {{XREF_1}} para o seu domínio personalizado. Isso é obrigatório para acesso ao OSS Console, pois o console impõe o uso de HTTPS.
Antes de executar o código de exemplo, substitua os espaços reservados, como<region-id>, pelo seu {{XREF_2}} real, por exemplo,ap-southeast-1
.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Saída bem-sucedida:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Configuração do cliente
Nomes de domínio personalizados
{{XREF_3}} para ativar a visualização de arquivos baseada em navegador e a aceleração de CDN.
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo seu {{XREF_4}} , como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Controle de tempo limite
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo seu {{XREF_5}} , como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Número máximo de tentativas de repetição
O OSSClient repete solicitações com falha 3 vezes por padrão.
Use WithRetryMaxAttempts para aumentar as repetições em cenários de alta concorrência ou rede instável.
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo {{XREF_6}} , como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Protocolo HTTP/HTTPS
Use WithDisableSSL(true) para alternar de HTTPS para HTTP.
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo {{XREF_7}} real, como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Servidor proxy
Use WithProxyHost para rotear solicitações por meio de um servidor proxy.
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo {{XREF_8}} , comoap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Endpoint interno
Use um endpoint interno quando sua aplicação for executada em uma instância ECS na mesma região do bucket para reduzir custos e latência.
Antes de executar o código de exemplo, substitua os espaços reservados, como<region-id>, pelo seu {{XREF_9}} , como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Endpoint acelerado
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo ID do seu {{XREF_10}} , comoap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Domínio privado
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo ID correto com base no seu {{XREF_11}} , comoap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Endpoints da nuvem governamental
O exemplo a seguir mostra como configurar o cliente OSS para usar endpoints do {{XREF_13}}.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Acessar buckets do CloudBox
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo {{XREF_14}} real, comoap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Personalizar o cliente HTTP
Use WithHTTPClient para substituir o cliente HTTP padrão quando os parâmetros padrão forem insuficientes.
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo seu {{XREF_15}} real, como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Configuração de credenciais de acesso
Escolha um método de credencial que atenda às suas necessidades de autenticação.
Usar o AK de um usuário do RAM
Para acesso de longo prazo em ambientes seguros, inicialize um provedor de credenciais com o par de AccessKey de um usuário do RAM (AccessKey ID e AccessKey secret). O gerenciamento manual de chaves aumenta os riscos de segurança.
Uma conta da Alibaba Cloud tem permissões totais. Um par de AccessKey vazado representa um grande risco de segurança. Use o par de AccessKey de um usuário do RAM com as permissões mínimas necessárias.
{{XREF_16}} para o usuário do RAM. O AccessKey ID e o secret são exibidos apenas na criação. Salve-os imediatamente — se perdidos, crie um novo par.
Variáveis de ambiente
-
Defina as variáveis de ambiente usando o par de AccessKey de um usuário do RAM.
Linux
-
Execute os seguintes comandos na CLI para adicionar as configurações das variáveis de ambiente ao arquivo
~/.bashrc:2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.-
Aplique as alterações.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Verifique se as variáveis de ambiente entraram em vigor:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
-
macOS
-
Execute o seguinte comando no terminal para visualizar o tipo de shell padrão:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.-
Configure as variáveis de ambiente com base no tipo de shell padrão.
Zsh
-
Execute os seguintes comandos para adicionar as configurações das variáveis de ambiente ao arquivo
~/.zshrc:2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Aplique as alterações.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Verifique se as variáveis de ambiente entraram em vigor:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Bash
-
Execute os seguintes comandos para adicionar as configurações das variáveis de ambiente ao arquivo
~/.bash_profile:2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Aplique as alterações.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Verifique se as variáveis de ambiente entraram em vigor:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
-
-
Windows
CMD
-
Execute os seguintes comandos no CMD:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.-
Verifique se as variáveis de ambiente entraram em vigor:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
-
PowerShell
-
Execute os seguintes comandos no PowerShell:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.-
Verifique se a variável de ambiente entrou em vigor:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
-
-
Após definir as variáveis de ambiente, reinicie sua IDE, terminal e quaisquer aplicações em execução para carregá-las.
-
Carregue as credenciais a partir das variáveis de ambiente.
Antes de executar este código de exemplo, substitua o espaço reservado
<region-id>pelo seu {{XREF_17}} real, como ouap-southeast-1.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Credenciais estáticas
Codifique as credenciais estáticas diretamente na sua aplicação.
Não incorpore credenciais de acesso no código da aplicação para ambientes de produção. Este método é apenas para fins de teste.
Antes de executar este código de exemplo, substitua o espaço reservado<region-id>pelo seu {{XREF_18}} real, como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Credenciais de acesso temporário do STS
Para acesso temporário ao OSS, inicialize um provedor de credenciais com credenciais do STS (AccessKey ID, AccessKey secret e token de segurança). Você deve gerenciar a atualização do token manualmente.
Obtenha credenciais de acesso temporário chamando {{XREF_19}}.
Obtenha credenciais de acesso temporário com um SDK: {{XREF_20}}.
Os tokens do STS expiram após a duração especificada. Tokens expirados não podem ser usados.
Para obter uma lista de endpoints do service STS, consulte {{XREF_21}}.
Variáveis de ambiente
-
Defina as variáveis de ambiente com suas credenciais de acesso temporário.
Mac OS X/Linux/Unix
AvisoEstas credenciais são as credenciais de acesso temporário do STS (AccessKey ID, AccessKey secret e token de segurança), e não o par de AccessKey de um usuário do RAM.
Um AccessKey ID do STS começa com
STS., por exemplo,STS.****************.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.Windows
AvisoEstas credenciais são as credenciais de acesso temporário do STS (AccessKey ID, AccessKey secret e token de segurança), e não o par de AccessKey de um usuário do RAM.
Um AccessKey ID do STS começa com
STS., por exemplo,STS.****************.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Carregue as credenciais a partir das variáveis de ambiente.
Antes de executar o código de exemplo, substitua o espaço reservado
<region-id>por um {{XREF_22}} real, como ouap-southeast-1.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Credenciais estáticas
Codifique as credenciais de acesso temporário diretamente na sua aplicação.
Não incorpore credenciais de acesso no código de produção. Este método é apenas para testes.
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>por um {{XREF_23}} real, como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Usar RAMRoleARN
Para acesso ao OSS entre contas ou delegado, use o RAMRoleARN. A ferramenta Credentials obtém e atualiza automaticamente os tokens do STS via AssumeRole. Use o parâmetro policy para restringir permissões.
Uma conta da Alibaba Cloud tem permissões totais. Uma chave de acesso vazada representa um grande risco de segurança. Use a chave de acesso de um usuário do RAM com as permissões mínimas necessárias.
{{XREF_24}} para o usuário do RAM. O ID e o secret da chave de acesso são exibidos apenas na criação. Salve-os imediatamente — se perdidos, crie um novo par.
{{XREF_25}} para obter um RAMRoleARN.
-
Adicione a dependência de credenciais.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Configure as credenciais de acesso.
Antes de executar o código de exemplo, substitua o espaço reservado
<region-id>por um {{XREF_26}} real, como ouap-southeast-1.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Usar um ECSRAMRole
Para aplicações em ECS, ECI ou nós de trabalho do Container Service for Kubernetes, use o ECSRAMRole. Ele atualiza automaticamente os tokens do STS para ECS, ECI ou nós de trabalho do Container Service for Kubernetes, eliminando o gerenciamento manual de credenciais. {{XREF_27}} antes de prosseguir.
-
Adicione a dependência de credenciais.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Configure as credenciais de acesso.
Antes de executar o código de exemplo, substitua o espaço reservado
<region-id>pelo seu {{XREF_28}} , como ouap-southeast-1.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Usar OIDCRoleARN
Para aplicações não confiáveis em nós de trabalho do Container Service for Kubernetes (ACK), use o RRSA baseado em OIDC para impor o privilégio mínimo no nível do pod. O ACK monta um arquivo de token OIDC por pod, e a ferramenta Credentials chama AssumeRoleWithOIDC para obter tokens do STS automaticamente. {{XREF_29}}.
-
Adicione a dependência de credenciais.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Configure as credenciais de acesso.
Antes de executar o código de exemplo, substitua o espaço reservado
<region-id>pelo seu {{XREF_30}} , como ouap-southeast-1.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Provedor de credenciais personalizado
Implemente um provedor personalizado se os métodos padrão não atenderem aos seus requisitos.
-
Usar a interface credentials.CredentialsProviderFunc
Antes de executar o código de exemplo, substitua o espaço reservado
<region-id>por um {{XREF_31}} válido, comoap-southeast-1.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Implementar a interface credentials.CredentialsProvider
Antes de executar o código de exemplo, substitua o espaço reservado
<region-id>por um {{XREF_32}} válido, comoap-southeast-1.2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Usar a cadeia de provedores de credenciais padrão
Se nenhum parâmetro for fornecido, o SDK usa o {{XREF_33}} para encontrar credenciais automaticamente.
Antes de executar o código de exemplo, substitua o espaço reservado<region-id>pelo seu {{XREF_34}} , como ouap-southeast-1.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service.
Http Status Code: 404.
Error Code: NoSuchKey.
Request Id: 67CA9CAADC44E03938AD91F0.
Message: The specified key does not exist..
EC: 0026-00000001.
Timestamp: 2025-03-07 07:13:46 +0000 UTC.
Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk.
Solução de problemas
Os erros do OSS incluem um código de status HTTP, mensagem, ID da solicitação e código de erro EC. Use o código EC para identificar a causa raiz.
-
Por exemplo, ao usar o código a seguir para baixar um objeto que não existe:
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
A seguir, um exemplo de mensagem de erro retornada. Ela inclui o código de erro EC 'EC': '0026-00000001', que identifica de forma única a causa do erro.
2025/03/07 15:13:46 failed to get object operation error GetObject: Error returned by Service. Http Status Code: 404. Error Code: NoSuchKey. Request Id: 67CA9CAADC44E03938AD91F0. Message: The specified key does not exist.. EC: 0026-00000001. Timestamp: 2025-03-07 07:13:46 +0000 UTC. Request Endpoint: GET https://xxx.oss-cn-hangzhou.aliyuncs.com/asdgkhfk. -
Para solucionar o erro usando o código de erro EC do exemplo, siga estas etapas:
Na caixa de pesquisa, insira o código de erro EC, como 0026-00000001. Em seguida, cole a mensagem de erro que contém o ID da solicitação na caixa de texto e clique em Diagnose.
O diagnóstico mostra a causa do erro e a solução. Para o código de erro EC
0026-00000001: o objeto de destino não existe. As possíveis causas incluem falha no upload, exclusão por regra de ciclo de vida, exclusão por outro usuário ou sincronização de replicação entre regiões. Verifique o objeto com HeadObject, confira as versões com ListObjectVersions e revise as convenções de nomenclatura, regras de ciclo de vida, permissões e regras de replicação. Erros relacionados: NoSuchKey e NoSuchVersion.
Código de exemplo
Códigos de exemplo e arquivos de origem disponíveis:
|
Descrição |
Arquivo de exemplo |
|
{{XREF_35}} |
|
|
{{XREF_36}} |
|
|
{{XREF_37}} |
|
|
{{XREF_38}} |
|
|
{{XREF_39}} |
|
|
{{XREF_40}} |
|
|
{{XREF_41}} |
|
|
{{XREF_42}} |
|
|
{{XREF_43}} |
|
|
{{XREF_44}} |
|
|
{{XREF_45}} |
|
|
{{XREF_46}} |
|
|
{{XREF_47}} |
|
|
{{XREF_48}} |
|
|
{{XREF_49}} |
|
|
{{XREF_50}} |
- |
|
{{XREF_51}} |
|
|
{{XREF_52}} |
|
|
{{XREF_53}} |
|
|
{{XREF_54}} |
- |
|
{{XREF_55}} |
|
|
{{XREF_56}} |
|
|
{{XREF_57}} |
- |
|
{{XREF_58}} |
|
|
{{XREF_59}} |
|
|
{{XREF_60}} |
|
|
{{XREF_61}} |
|
|
{{XREF_62}} |
|
|
{{XREF_63}} |
|
|
{{XREF_64}} |
|
|
{{XREF_65}} |
|
|
{{XREF_66}} |
|
|
|
|
{{XREF_70}} |
|
|
{{XREF_71}} |
|
|
{{XREF_72}} |
|
|
{{XREF_73}} |
|
|
{{XREF_74}} |
|
|
{{XREF_75}} |
|
|
{{XREF_76}} |
|
|
{{XREF_77}} |
|
|
{{XREF_78}} |
|
|
{{XREF_79}} |
|
|
{{XREF_80}} |
|
|
{{XREF_81}} |
|
|
{{XREF_82}} |
|
|
{{XREF_83}} |
|
|
{{XREF_84}} |
|
|
{{XREF_85}} |
|
|
{{XREF_86}} {{XREF_87}} |
|
|
{{XREF_88}} |
|
|
{{XREF_89}} |
|
|
{{XREF_90}} |
|
|
{{XREF_91}} |
|
|
{{XREF_92}} |
|
|
{{XREF_93}} |
|
|
{{XREF_94}} |
|
|
{{XREF_95}} |
- |