Nomes principais para buckets de armazenamento de objetos Lightsail - Amazon Lightsail
Nomes de chaveDiretrizes de nomeação de chave de objetoXMLrestrições de chave de objeto relacionadas

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 o Amazon API 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 alguns aplicativos e protocolos. As diretrizes a seguir ajudam a maximizar a conformidade com caracteres seguros para a WebDNS, XML analisadores 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 terminado em um ou dois pontos, você deve usar o Amazon S3 API 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 de código e provavelmente precisam ser URL codificados 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 (“$”)

  • ASCIIintervalos de caracteres 00—1F hexadecimal (0—31 decimais) e 7F (127 decimais)

  • 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 todos os aplicativos.

  • Barra invertida (“\”)

  • Chave esquerda (“{”)

  • Caracteres não imprimíveis (128—255 ASCII 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 (“|”)

XMLrestrições de chave de objeto relacionadas

Conforme especificado pelo XMLpadrão de end-of-line manuseio, todo o XML texto é normalizado para que os retornos de carro único (ASCIIcódigo 13) e os retornos de carro imediatamente seguidos por uma alimentação de linha (ASCIIcódigo 10) sejam substituídos por um caractere de alimentação de linha única. Para garantir a análise correta das chaves do objeto nas XML solicitações, os retornos de transporte e outros caracteres especiais devem ser substituídos pelo código de XML entidade equivalente quando inseridos nas XML tags. 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 XML entidade como substituto de uma devolução de transporte. 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>