Skip to main content

Erro "Conditional object PUTs are not supported" no Proxmox Backup Server

Descrição do Problema​

Falhas de upload do Proxmox Backup Server (PBS) para Object Storage da Magalu Cloud com o seguinte erro:

ERRO 2025-09-02T17:58:21-03:00: Chunkstore create: 99%
2025-09-02T17:58:22-03:00: <e><Code>NotImplemented</Code><Message>Conditional object PUTs are not supported.</Message></e>
2025-09-02T17:58:22-03:00: TASK ERROR: access time safety check failed: failed to upload chunk to s3 backend: chunk upload failed: unexpected status code 501 Not Implemented

Versões Afetadas​

  • Proxmox Backup Server: Todas as versões 4.0 ou superior
  • Object Storage Magalu Cloud: Todas as versões

Análise da Causa​

O Proxmox Backup Server utiliza Conditional Object PUTs durante operações de upload, enviando cabeçalhos HTTP como If-None-Match e If-Match para verificar a existência de objetos antes da gravação. Esta funcionalidade S3 não é suportada pelo Object Storage da Magalu Cloud, resultando em resposta HTTP 501 Not Implemented.

Detalhes Técnicos:

  • O PBS usa cabeçalhos condicionais para otimização de uploads e verificações de integridade
  • O Object Storage identifica corretamente a operação não suportada
  • Não é um problema de autenticação ou permissões de acesso

Resolução​

Configure o PBS para não enviar cabeçalhos condicionais ao Object Storage da Magalu Cloud.

Passo 1: Acessar Configuração do Endpoint S3​

  1. Acesse a Interface Web do Proxmox Backup Server
  2. Navegue para Datacenter → Storage
  3. Selecione o endpoint S3 existente ou clique Add → S3

Passo 2: Configurar Provider Quirks​

  1. No diálogo de configuração S3, expanda Advanced Options
  2. Localize a seção Provider Quirks
  3. Marque a opção: Skip If-None-Match header
  4. Configure os parâmetros
  5. Salve com Apply (endpoint existente) ou Add (novo endpoint)

Passo 3: Validar Configuração​

  1. Teste a conectividade clicando Test Connection

  2. Confirme que a configuração mostra:

    Provider Quirks: Skip If-None-Match header: Yes

Passo 4: Testar Backup​

  1. Configure um datastore utilizando o endpoint S3 modificado
  2. Execute um backup de teste para validar o upload de chunks
  3. Verifique os logs para confirmar ausência de erros 501

Comportamento Esperado​

Após a configuração:

  • Uploads de backup executam sem erros HTTP 501
  • Chunks são enviados normalmente para o Object Storage
  • Integridade dos backups é mantida
  • Operações de restore não são afetadas

Considerações Técnicas​

Impacto da Solução:

  • PBS não enviará cabeçalhos condicionais (If-None-Match, If-Match)
  • Nenhum impacto na integridade ou segurança dos dados

Quando Aplicar:

  • Todos os casos de integração PBS com Object Storage Magalu Cloud

Diagnóstico Adicional​

Se o problema persistir após a configuração:

  1. Verificar credenciais: Confirme Access Key e Secret Key no console Magalu Cloud
  2. Validar permissões: Certifique-se que a chave tem permissões de leitura/escrita no bucket
  3. Verificar conectividade: Teste conectividade de rede entre PBS e Object Storage
  4. Analisar logs: Revise logs completos do PBS para identificar outros erros

Informações de Referência​

  • Códigos de Erro: HTTP 501 Not Implemented, S3 NotImplemented
  • Operações Afetadas: Upload de chunks
  • Forum Proxmox Backup Server: Forum Proxmox Backup Server