Nomes principais para buckets de armazenamento de objetos Lightsail - Amazon Lightsail
Nomes de chaveDiretrizes de nomeação de chave de objetoRestrições de chave de objeto relacionado a XML

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Nomes principais para buckets de armazenamento de objetos Lightsail

Os arquivos que você carrega no seu bucket são armazenados como objetos no serviço de armazenamento de objetos Amazon Lightsail. Uma chave de objeto (ou nome da chave) identifica, unicamente, um objeto armazenado em um bucket. Este guia explica o conceito de nomes e prefixos de nomes de chaves que compõem a estrutura de pastas dos buckets visualizados por meio do console do Lightsail. Para obter mais informações sobre buckets, consulte Armazenamento de objetos.

Nomes de chave

O modelo de dados do serviço de armazenamento de objetos Lightsail usa uma estrutura plana em vez de uma estrutura hierárquica, como você veria em um sistema de arquivos. Não há hierarquia de pastas e de subpastas. No entanto, você pode deduzir a hierarquia lógica usando prefixos e delimitadores de nome de chave. O console do Lightsail usa os prefixos do nome da chave para exibir seus objetos em uma estrutura de pastas.

Suponha que seu bucket tenha quatro objetos com as seguintes chaves de objeto:

  • Development/Projects.xls

  • Finance/statement1.pdf

  • Private/taxdocument.pdf

  • to-dos.doc

O console do Lightsail usa os prefixos do nome da chave Development/ (Finance/, Private/ e) e o delimitador / () para apresentar uma estrutura de pastas. O nome de chave to-dos.doc não tem um prefixo, de modo que seu objeto aparece diretamente no nível da raiz do bucket. Se você navegar até a Development/ pasta no console do Lightsail, verá o objeto. Projects.xls Na pasta do Finance/, você verá o objeto do statement1.pdf e, na pasta do Private/, você verá o objeto do taxdocument.pdf.

O console do Lightsail permite a criação de pastas criando um objeto de zero bytes com o prefixo do nome da chave e o valor do delimitador como nome da chave. Esses objetos de pasta não aparecem no console. No entanto, eles se comportam como quaisquer outros objetos. Você pode visualizá-los e manipulá-los usando a API do Amazon S3 AWS Command Line Interface ,AWS CLI() ou. AWS SDKs

Diretrizes de nomeação de chave de objeto

Você pode usar qualquer caractere UTF-8 em um nome de chave de objeto. No entanto, o uso de determinados caracteres em nomes de chave pode causar problemas com algumas aplicações e protocolos. As diretrizes a seguir ajudam a maximizar a conformidade com DNS, caracteres seguros para a Web, analisadores XML e outros. APIs

Caracteres seguros

Os seguintes conjuntos de caracteres são, geralmente, confiáveis para uso em nomes de chave.

  • Caracteres alfanuméricos

    • 0-9

    • a-z

    • A-Z

  • Caracteres especiais

    • Barra (/)

    • Ponto de exclamação (!)

    • Hífen (-)

    • Sublinhado (_)

    • Ponto final (.)

    • Asterisco (*)

    • Aspas simples (')

    • Abrir parênteses (()

    • Fechar parênteses ())

Os seguintes são exemplos de nomes de chave válidos:

  • 4my-organization

  • my.great_photos-2014/jan/myvacation.jpg

  • videos/2014/birthday/video1.wmv

Importante

Se o nome de uma chave de objeto terminar com um único ponto (.) ou dois pontos (..), você não poderá baixar o objeto usando o console do Lightsail. Para baixar um objeto com um nome de chave que termina com um ou dois pontos, você deve usar a API do Amazon S3 AWS CLI, e. AWS SDKs Para obter mais informações, consulte Download bucket objects.

Caracteres que podem exigir tratamento especial

Os caracteres a seguir em um nome de chave podem exigir tratamento adicional do código e, provavelmente, precisarão ser criptografados em URL ou referenciados como HEX. Alguns desses caracteres não são imprimíveis, e seu navegador pode não reconhecê-los, o que também exigirá tratamento especial:

  • Sinal tipográfico (“e”) ("&")

  • Dólar (“$”)

  • Caracteres ASCII variam de 00-1F em hexadecimal (0-31 decimal) e 7F (127 decimal)

  • Arroba (“@”)

  • Igual a (“=”)

  • Ponto-e-vírgula (“;”)

  • Dois pontos (“:”)

  • Mais (“+”)

  • Espaço: sequências significativas de espaços podem ser perdidas em alguns usos (especialmente múltiplos espaços)

  • Vírgula (“,”)

  • Ponto de interrogação (“?”)

Caracteres a serem evitados

Evite os caracteres a seguir em um nome de chave devido ao tratamento especial significativo necessário para consistência em todas as aplicações.

  • Barra invertida (“\”)

  • Chave esquerda (“{”)

  • Caracteres ASCII não imprimíveis (128-255 caracteres decimais)

  • Circunflexo (“^”)

  • Chave direita (“}”)

  • Caractere de porcentagem (“%”)

  • Crase (“`”)

  • Colchete direito (“]”)

  • Pontos de interrogação

  • Sinal de maior (">") (">")

  • Colchete esquerdo (“[”)

  • Til (“~”)

  • Sinal de menor ("<") ("<")

  • Caractere de libra (“#”)

  • Barra vertical (“|”)

Restrições de chave de objeto relacionado a XML

Conforme especificado pelo padrão XML de end-of-line manuseio, todo o texto XML é normalizado para que os retornos de um único carro (código ASCII 13) e os retornos de carro imediatamente seguidos por uma alimentação de linha (código ASCII 10) sejam substituídos por um único caractere de alimentação de linha. Para garantir a análise correta de chaves de objeto em solicitações XML, retornos de carro e outros caracteres especiais devem ser substituídos por seu código de entidade XML equivalente quando forem inseridos em tags XML. A seguinte lista mostra os tais caracteres especiais e seus códigos de entidade equivalentes:

  • ' como &apos;

  • ” como &quot;

  • & como &amp;

  • < como &lt;

  • < como &gt;

  • \r como &#13; ou &#x0D;

  • \n como &#10; ou &#x0A;

O exemplo a seguir ilustra o uso de um código de entidade XML como uma substituição para um retorno de carro. Esta solicitação DeleteObjects exclui um objeto com o parâmetro /some/prefix/objectwith\rcarriagereturn (onde \r é o “carriage return”).

<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
      <Object>
        <Key>/some/prefix/objectwith&#13;carriagereturn</Key>
      </Object>
    </Delete>