Nombres clave de los depósitos de almacenamiento de objetos de Lightsail - Amazon Lightsail
Nombres de clavesDirectrices de nomenclatura de claves de objetoXMLrestricciones clave de objetos relacionados

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Nombres clave de los depósitos de almacenamiento de objetos de Lightsail

Los archivos que subas a tu bucket se almacenan como objetos en el servicio de almacenamiento de objetos de Amazon Lightsail. Una clave de objeto (o el nombre de clave) identifica exclusivamente un objeto almacenado en un bucket. Esta guía explica el concepto de nombres clave y prefijos de nombres clave que componen la estructura de carpetas de los depósitos que se ven a través de la consola Lightsail. Para obtener más información sobre los buckets, consulte Almacenamiento de objetos.

Nombres de claves

El modelo de datos del servicio de almacenamiento de objetos de Lightsail utiliza una estructura plana en lugar de una estructura jerárquica como la que se vería en un sistema de archivos. No existe una jerarquía de carpetas y subcarpetas. Sin embargo, puede inferir una jerarquía lógica con prefijos de nombres de clave y delimitadores. La consola Lightsail utiliza los prefijos de los nombres clave para mostrar los objetos en una estructura de carpetas.

Supongamos que el bucket tiene cuatro objetos con las siguientes claves de objeto:

  • Development/Projects.xls

  • Finance/statement1.pdf

  • Private/taxdocument.pdf

  • to-dos.doc

La consola Lightsail utiliza los prefijos de los nombres clave Development/ (Finance/, Private/ y) y el delimitador / () para presentar una estructura de carpetas. El nombre de clave to-dos.doc no tiene un prefijo, por lo que su objeto aparece directamente en el nivel raíz del bucket. Si busca la Development/ carpeta en la consola de Lightsail, verá el objeto. Projects.xls En la carpeta Finance/, verá el objeto statement1.pdf, y en la carpeta Private/, verá el objeto taxdocument.pdf.

La consola de Lightsail permite la creación de carpetas mediante la creación de un objeto de cero bytes con el prefijo del nombre de la clave y el valor del delimitador como nombre de la clave. Estos objetos de carpeta no aparecen en la consola. Sin embargo, se comportan como cualquier otro objeto. Puede verlos y manipularlos con Amazon S3API, AWS Command Line Interface (AWS CLI) o AWS SDKs.

Directrices de nomenclatura de claves de objeto

Puede usar cualquier carácter UTF -8 en el nombre de la clave de un objeto. Sin embargo, el uso de ciertos caracteres en los nombres de las claves puede provocar problemas con algunas aplicaciones y protocolos. Las siguientes pautas le ayudan a maximizar el cumplimiento de los caracteres seguros para la WebDNS, los XML analizadores sintácticos y otros. APIs

Caracteres seguros

Los siguientes conjuntos de caracteres son habitualmente seguros para su uso en nombres de claves.

  • Caracteres alfanuméricos

    • 0-9

    • a-z

    • A-Z

  • Caracteres especiales

    • Barra inclinada (/)

    • Signo de exclamación (!)

    • Guion (-)

    • Guion bajo (_)

    • Punto (.)

    • Asterisco (*)

    • Comilla simple (')

    • Abrir paréntesis (()

    • Cerrar paréntesis ())

A continuación se proporcionan ejemplos de nombres de claves de objeto válidos:

  • 4my-organization

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

  • videos/2014/birthday/video1.wmv

importante

Si el nombre de la clave de un objeto termina con un único punto (.) o con dos puntos (..), no podrá descargar el objeto mediante la consola Lightsail. Para descargar un objeto cuyo nombre de clave termine en uno o dos puntos, debe utilizar Amazon S3 API AWS CLI, y AWS SDKs. Para obtener más información, consulte Descarga de objetos desde un bucket.

Caracteres que podrían requerir un trato especial

Es posible que los siguientes caracteres del nombre de una clave requieran un manejo de código adicional y es probable que deban URL codificarse o hacer referencia a ellos comoHEX. Algunos de ellos son caracteres no imprimibles que su navegador podría no admitir, por lo que también requieren un trato especial:

  • Ampersand ("&")

  • Dólar (“$“)

  • ASCIIrangos de caracteres: 0—1F en hexadecimal (0—31 decimales) y 7F (127 decimales)

  • Arroba (“@“)

  • Igual (“=”)

  • Punto y coma (“;”)

  • Dos puntos (“:”)

  • Más (“+”)

  • Espacio: puede que se pierdan secuencias significativas de espacios en algunos usos (especialmente espacios múltiples)

  • Coma (“,”)

  • Signo de cierre de interrogación (“?”)

Caracteres que deben evitarse

Evite los siguientes caracteres en un nombre de clave debido a un trato significativamente especial para que sean coherentes en todas las aplicaciones.

  • Barra diagonal invertida (“\”)

  • Llave de apertura (“{”)

  • Caracteres no imprimibles ASCII (128 a 255 caracteres decimales)

  • Acento circunflejo (“^”)

  • Llave de cierre (“}”)

  • Carácter de porcentaje (“%”)

  • Acento grave (“`”)

  • Corchete de cierre (“]”)

  • Comillas

  • Símbolo mayor que (">")

  • Corchete de apertura (“[”)

  • Virgulilla (“~”)

  • Símbolo menor que ("<")

  • Almohadilla (“#”)

  • Barra vertical (“|”)

XMLrestricciones clave de objetos relacionados

Como se especifica en la XML norma de end-of-line manipulación, todo el XML texto está normalizado, de modo que las devoluciones de un solo vagón (ASCIIcódigo 13) y las devoluciones de vagones seguidas inmediatamente por una línea (ASCIIcódigo 10) se sustituyen por un carácter de alimentación de una sola línea. Para garantizar el correcto análisis de las claves de objeto en las XML solicitudes, las devoluciones de transporte y otros caracteres especiales deben sustituirse por su código de XML entidad equivalente cuando se inserten en XML las etiquetas. A continuación se muestra una lista de estos caracteres especiales y sus códigos de entidad equivalentes:

  • ' como &apos;

  • ” como &quot;

  • & como &amp;

  • < como &lt;

  • < como &gt;

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

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

El siguiente ejemplo ilustra el uso de un código de XML entidad como sustituto de una devolución de transporte. Esta solicitud DeleteObjects elimina un objeto con el parámetro de clave /some/prefix/objectwith\rcarriagereturn (donde \r es el retorno de carro).

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