Compartilhamento de uma pasta

Cenário de aplicação

Você pode compartilhar pastas com outros usuários temporariamente ou permanentemente.

• Partilha temporária:

  Compartilhar uma pasta com outros usuários por meio do URL temporário do arquivo. Todos os URL compartilhados são temporários com um período de validade.

  Você precisa preparar um código de extração de seis dígitos antes de compartilhar uma pasta. Depois que o link de compartilhamento da pasta é criado, o OBS agrega automaticamente os links de download de todos os objetos na pasta a um site estático hospedado por um bucket público do OBS. Em seguida, os usuários que têm o URL temporário e o código de extração podem acessar o site estático e fazer o download de arquivos.

  Um URL temporário consiste no nome de domínio de acesso e nas informações de autenticação temporária de uma pasta. Exemplo:

  https://bucketname.obs.cn-north-4.myhuaweicloud.com:443/image.png?AccessKeyId=xxx&Expires=xxx&response-content-disposition=xxx&x-obs-security-token=xxx&Signature=xxx

  As informações de autenticação temporária contêm os parâmetros AccessKeyId, Expires, x-obs-security-token, e Signature. Os parâmetros AccessKeyId, x-obs-security-token, e Signature são usados para autenticação. O parâmetro Expires especifica o período de validade da autenticação.

  Para obter detalhes sobre o método e os parâmetros de autenticação temporária, consulte Autenticação de assinatura em um URL em Referência de API de Object Storage Service.

  Um URL temporário também contém o parâmetro response-content-disposition, que define se um objeto é diretamente baixado ou visualizado no navegador da Web quando é acessado. O valor é determinado pelo navegador da Web com base no Content-Type do objeto compartilhado.

• Compartilhamento permanente:

  Se você definir a permissão de um objeto para permitir que usuários anônimos o leiam, os usuários anônimos poderão acessar o objeto por meio da URL que você compartilhou. Para obter detalhes sobre como configurar permissões, consulte Concessão de permissões de leitura pública em objetos para usuários anônimos.

  Para obter detalhes sobre como obter o URL de acesso ao objeto, consulte Como obtenho o caminho de acesso a um objeto?

  Se você não conseguiu acessar um objeto, corrija o problema de acordo com Falha ao acessar um objeto por meio de sua URL.

Restrições

• You need to restore an Archive object before sharing it to other users.
• A função de compartilhamento de pastas é restrita a apenas algumas regiões.
• Somente os buckets da versão 3.0 ou posterior suportam o compartilhamento temporário de pastas. Para obter detalhes sobre como consultar a versão do bucket, consulte Verificação da versão do OBS (OBS 2.0 ou OBS 3.0).
• A tabela a seguir descreve o período de validade do URL das pastas que são compartilhadas temporariamente usando ferramentas diferentes.

  Ferramenta	Período de validade do URL
  Console de OBS	O URL é válido por 1 minuto a 18 horas. Depois que um objeto é compartilhado, o sistema irá gerar uma URL que contém as informações de autenticação temporária, válida por cinco minutos desde a sua geração por padrão. Cada vez que você altera o período de validade de um URL, OBS obtém as informações de autenticação novamente para gerar um novo URL para compartilhamento. O novo URL torna-se válido no momento em que o período de validade é alterado.
  As API	Configure o parâmetro Expires para especificar quando uma autorização temporária expira. A autorização temporária expira em 24 horas.
  OBS Browser+	Quando você faz login no OBS Browser+ usando uma conta e senha, um URL compartilhado será válido por no máximo 24 horas. O período de validade padrão é de 10 horas. Se for necessário um período de validade mais longo, use o AK/SK permanente para fazer login.
  obsutil	Use o parâmetro adicional vp para especificar por quanto tempo um código de autorização é válido. O período de validade padrão é de um dia. As unidades permitidas incluem m (meses), w (semanas), d (dias), h (horas), min (minutos) e s (segundos). Se nenhuma unidade de tempo for especificada, o valor é calculado em segundos.

Como usar essa função

Você pode usar Console do OBS, os SDK, as API, OBS Browser+, ou obsutil para compartilhar pastas.