No object storage service (oss), o objeto é a unidade básica de armazenamento de dados e funciona de forma semelhante a um arquivo. Qualquer arquivo, como um documento, imagem ou vídeo, é armazenado como um objeto em um bucket para gerenciamento.
Componentes de um objeto
Chave: O nome do objeto. É usado para consultar o objeto e deve ser único.
Dados: Os dados reais do objeto. Consistem em uma sequência de bytes.
Object Meta: Os metadados do objeto. Os metadados são um conjunto de pares chave-valor que descrevem as propriedades do objeto, como a data da última modificação e o tamanho. Você também pode usar os metadados para armazenar informações personalizadas.
Version id: Se você ative o recurso de versioning, poderá salve várias versões de um objeto. Cada vez que você faz o upload de um objeto com um nome que já existe, o oss crie uma nova versão e atribui a ela um id de versão exclusivo. Esse id é usado para acessar e gerencie versões específicas do objeto.
Nomenclatura de objetos (Chave)
Cada objeto tem um nome exclusivo, chamado de chave. Por exemplo, a chave "exampledir/example.jpg" representa o arquivo example.jpg na pasta exampledir.
Na documentação do SDK, a chave também é chamada de ObjectKey, ObjectName ou nome do objeto. Esses termos têm o mesmo significado.
Convenções de nomenclatura
Use a codificação UTF-8.
O comprimento deve estar entre 1 e 1.023 bytes.
Não comece com uma barra (/) ou uma barra invertida (\).
As chaves diferenciam maiúsculas de minúsculas.
Recomendações de nomenclatura
Use nomes significativos, como nomes de arquivos, datas ou ids de usuário, para facilitar a busca e a compreensão dos objetos.
Use prefixos para organizar os dados. crie uma hierarquia utilizando prefixos como datas, ids de usuário ou regiões.
Garanta a exclusividade dos nomes. Inclua números aleatórios ou UUIDs nos nomes dos objetos para evitar conflitos.
Exemplos de nomenclatura
|
Localização do objeto no bucket |
Representação da chave |
|
Um objeto chamado exampleobject.txt é armazenado no diretório raiz do bucket examplebucket. |
exampleobject.txt |
|
Um objeto chamado exampleobject.jpg é armazenado no diretório destdir, dentro do diretório raiz do bucket examplebucket. |
destdir/exampleobject.jpg |
Exibição de diretórios do oss
No oss, não existem conceitos tradicionais de sistemas de arquivos, como arquivos e pastas. Para melhorar a experiência do usuário, barras (/) são usadas nas chaves dos objetos para simular uma estrutura de pastas, como exampledir/example.jpg. O exemplo fornecido simula exampledir como uma pasta e example.jpg como um arquivo dentro de exampledir. Essa estrutura semelhante a pastas é visível no console do oss e em ferramentas gráficas como o ossbrowser. No entanto, a chave do objeto permanece exampledir/example.jpg. Para mais informações, consulte Manage directories.
Tipos de objeto
Os objetos podem ser classificados em quatro tipos com base em seus métodos de criação. A tabela a seguir descreve esses quatro tipos.
Os objetos não podem ser convertidos de um tipo para outro. Por exemplo, um objeto Normal não pode ser convertido em um objeto Multipart ou Appendable.
|
Tipo |
Definição |
Descrição |
|
Normal |
Objetos deste tipo são criados usando simple upload. |
|
|
Multipart |
Objetos deste tipo são criados usando multipart upload. |
|
|
Appendable |
Objetos deste tipo são criados usando append upload. |
Quando dados são anexados a um objeto appendable, o oss não crie uma nova versão do objeto, independentemente do status de versionamento. Os dados são anexados diretamente ao objeto original. |
|
Symlink |
Objetos deste tipo são criados usando links simbólicos gerados ao chamar a operação PutSymlink. |
Use symbolic links para acessar objetos que são acessados com frequência. |
Marcadores de exclusão
o oss usa um tipo especial de marcador de objeto chamado delete marker. Ao chamar a operação DeleteObject para exclua um objeto em um bucket com versionamento ativado ou suspenso, o oss gera um delete marker para o objeto. Se você não especifique um id de versão durante a exclusão, o oss atribui o delete marker como a versão mais recente do objeto. Isso garante a preservação dos dados no objeto, permitindo sua restauração mesmo após a exclusão. No entanto, se você especifique um id de versão, o oss exclua a versão específica e não gera um delete marker.
Recursos
Upload de objetos
|
Procedimento |
Descrição |
|
Use a operação de API PutObject para fazer o upload de um único arquivo menor que 5 GB. Este método é adequado para uploads que podem ser concluídos em uma única solicitação http. |
|
|
Divida um arquivo em várias partes e faça o upload delas separadamente. Após o upload de todas as partes, chame a operação de API CompleteMultipartUpload para combinar as partes em um único objeto. |
|
|
especifique um ponto de verificação em um arquivo de checkpoint. Se um upload falhar devido a um erro de rede ou falha do programa, o upload será retomado a partir do ponto de verificação registrado para transferir as partes restantes. |
|
|
O oss pode enviar um callback para um servidor de aplicativos após a conclusão do upload de um arquivo. Para implementar um callback, inclua os parâmetros de callback correspondentes na solicitação enviada ao oss. |
|
|
Faça o upload de arquivos diretamente de um cliente para o oss. Este método evita o roteamento de arquivos pelo seu servidor de aplicativos, o que melhora a velocidade de upload e economiza recursos do servidor. |
|
|
Use a operação de API PostObject para fazer o upload de um arquivo a partir de um formulário HTML. O arquivo carregado não pode exceder 5 GB. |
|
|
Anexe conteúdo diretamente ao final de um objeto Appendable existente. |
|
|
Use o Real-Time Messaging Protocol (RTMP) para ingerir fluxos de vídeo codificados em H.264 e fluxos de áudio codificados em AAC no oss. Os dados de áudio e vídeo carregados podem ser reproduzidos sob demanda ou utilizados para transmissão ao vivo em cenários onde a latência não é um fator crítico. |
baixe de objetos
|
Procedimento |
Descrição |
|
Use a operação de API GetObject para baixe um arquivo carregado. Este método é adequado para downloads que podem ser concluídos em uma única solicitação http. |
|
|
baixe um arquivo a partir de uma posição especificada. Ao baixe arquivos grandes, você pode fazer o baixe em várias partes. Se o download for interrompido, retome-o de onde parou. |
|
|
Após o upload de um arquivo para um bucket, compartilhe sua URL com terceiros para visualizar ou baixe. |
|
|
Os objetos são baixados apenas se o seu conteúdo tiver sido alterado, conforme determinado pela hora da última modificação ou pelo ETag. Este recurso garante que os downloads sejam acionados somente quando ocorrerem atualizações, evitando repetições desnecessárias. |
gerencie objetos
|
Procedimento |
Descrição |
|
Os objetos em um bucket são listados em ordem alfabética por padrão. Liste todos os objetos no bucket atual, objetos com um prefixo específico ou um número específico de objetos, conforme necessário. |
|
|
Copie um arquivo de um bucket de source para um bucket de destino na mesma região sem alterar o conteúdo do arquivo. |
|
|
Renomeie um objeto em um bucket. |
|
|
Quando um bucket contém muitos objetos, o oss permite pesquisar e localizar rapidamente um arquivo de destino especifique um prefixo de nome de arquivo. |
|
|
Antes de acessar um objeto no Cold Archive ou Deep Cold Archive, inicie um processo de restauração para o objeto. |
|
|
exclua objetos que você não precisa mais manter em um bucket usando vários métodos. |
|
|
O oss permite o uso de tags para classificar objetos em um bucket. defina regras de ciclo de vida e permissões de acesso para objetos com a mesma tag. |
|
|
O recurso de link simbólico é usado para acesso rápido a objetos frequentemente utilizados em um bucket. Após configurar um link simbólico, abra o objeto rapidamente usando o arquivo de link simbólico. |
|
|
Os metadados do objeto descrevem as propriedades de um arquivo. Eles incluem cabeçalhos http padrão e metadados definidos pelo usuário (User Meta). defina cabeçalhos http de arquivo para personalizar políticas de solicitação http, como políticas de cache e de baixe forçado. Você também pode definir metadados personalizados para identificar a finalidade ou as propriedades de um objeto. |
|
|
Quando um cliente acessa arquivos no oss, ele pode consumir uma grande quantidade de largura de banda, o que pode afetar outros aplicativos. Use o recurso de limitação de largura de banda de conexão única fornecido pelo oss para controlar o tráfego durante operações como upload e download de arquivos. Isso garante largura de banda de rede suficiente para outros aplicativos. |
|
|
Use o SelectObject para executar uma instrução SQL em um arquivo de destino e retornar o resultado da execução. |
|
|
Durante um upload multipart, se algumas partes não forem mais necessárias, chame a operação de API AbortMultipartUpload para exclua essas partes incompletas. |
|
|
Para permitir que vários usuários acessem recursos em um bucket do oss a partir de diferentes locais e dispositivos, use o cloud Storage Gateway (CSG) para mapear o bucket do oss para um sistema de armazenamento de arquivos compartilhado. Isso permite que os usuários realizem operações em recursos do oss como fariam com arquivos e discos locais. |