Cabeçalhos comuns e códigos de erro

As transferências de dados usam muitos protocolos padrão e têm requisitos exclusivos. Mantenha-se atualizado com a referência a cabeçalhos comuns e alguns códigos de erro.

Cabeçalhos comuns da solicitação

A tabela a seguir descreve os cabeçalhos de solicitação comuns suportados. O IBM Cloud® Object Storage ignora quaisquer cabeçalhos comuns que não estejam listados abaixo, caso sejam enviados como parte de uma solicitação, embora algumas solicitações possam suportar cabeçalhos adicionais, conforme definido neste documento.

Cabeçalho Nota
Autorização Necessário para todas as solicitações (token OAuth2 bearer).
ibm-service-instance-id Necessário para solicitações para criar ou listar depósitos.
Content-MD5 O hash MD5 binário de 128 bits codificado em base64 da carga útil, usado como uma verificação de integridade para assegurar que a carga útil não foi alterada em trânsito. A codificação base64 deve ser executada na saída binária do hash MD5, não na representação hexadecimal.
x-amz-checksum-crc32 Esse cabeçalho é a soma de verificação Base64 codificada e de 32 bits CRC32 do objeto.
x-amz-checksum-crc32c Esse cabeçalho é a soma de verificação Base64 codificada e de 32 bits CRC32C do objeto.
x-amz-checksum-crc64nvme Esse cabeçalho é a soma de verificação Base64 codificada e de 64 bits CRC64NVME do objeto. A soma de verificação CRC64NVME é sempre uma soma de verificação completa do objeto.
x-amz-checksum-sha1 Esse cabeçalho é o Base64 codificado, 160 bits SHA1 digest do objeto.
x-amz-checksum-sha256 Esse cabeçalho é o Base64 codificado, 256 bits SHA256 digest do objeto.
x-amz-sdk-checksum-algorithm Indica o algoritmo usado para criar a soma de verificação do objeto ao usar o SDK.
Expect O valor 100-continue aguarda confirmação do sistema de que os cabeçalhos são apropriados antes de enviar a carga útil.
host A sintaxe de endpoint ou a de “host virtual” de {bucket-name}.{endpoint}. Geralmente, esse cabeçalho é incluído automaticamente. Para obter mais informações sobre terminais, consulte Terminais e locais de armazenamento
Cache-Control Pode ser usado para especificar o comportamento de armazenamento em cache ao longo da cadeia de solicitação/resposta. Para obter mais informações, acesse http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9

Metadados customizados

Um benefício de uso do Object Storage é a capacidade de incluir metadados customizados enviando pares chave-valor como cabeçalhos. Esses cabeçalhos tomam a forma de x-amz-meta-{KEY}. Observe que, ao contrário de AWS S3, IBM Cloud Object Storage combina vários cabeçalhos com a mesma chave de metadados em uma lista de valores separados por vírgulas.

Cabeçalhos de resposta comuns

A tabela a seguir descreve os cabeçalhos de resposta comuns.

Cabeçalho Nota
Content-Length O comprimento do corpo da solicitação em bytes.
Connection Indica se a conexão está aberta ou encerrada.
Date O registro de data e hora da solicitação.
ETag O valor do hash MD5 da solicitação.
Server Nome do servidor de resposta.
X-Clv-Request-Id Identificador exclusivo gerado por solicitação.

Cabeçalhos de resposta do ciclo de vida

A tabela a seguir descreve os cabeçalhos de resposta para objetos arquivados

Cabeçalho Nota
x-amz-restore Incluído se o objeto tiver sido restaurado ou se uma restauração estiver em andamento.
x-amz-storage-class Retorna “ GLACIER ” ou “ ACCELERATED ” se o item estiver arquivado ou tiver sido restaurado temporariamente.
x-ibm-archive-transition-time Retorna a data e hora em que o objeto está planejado para fazer a transição para a camada de archive.
x-ibm-transition Incluído se o objeto tiver metadados de transição e retornar a camada e o horário original de transição.
x-ibm-restored-copy-storage-class Incluído se um objeto estiver nos estados RestoreInProgress ou Restored e retornará a classe de armazenamento do depósito.

Consulte a documentação da API para obter uma lista dos códigos de erro