StackOverflow2013

Note that there are some explanatory texts on larger screens.

plurals

PO
text
Body
copied!<p>Though often used for different purposes, the index document was originally intended, conceptually, to be the "index" (directory listing or other content summary) of all of the files within each folder, so this configuration parameter specifies the index document to return <em>for each folder in the entire bucket, if such a document exists within the folder</em>... this isn't a single configuration "thing" for the bucket as a whole.</p> <p>If your attempted configuration had been accepted by S3, it would have had the following impact, assuming a bucket name of "example.com":</p> <pre><code>browser address bar file (object) actually returned --------------------------- ------------------------------------ http://example.com example.com/test/index.html http://example.com/help example.com/help/test/index.html http://example.com/foo/test example.com/foo/test/test/index.html </code></pre> <p>It seems very unlikely that this is what you actually intended.</p> <p>However, but that is how index documents work... they are conceptually intended to be related to the other things at each level of the directory hierarchy, which of course could be the actual listing of files, or could be an "index" in a much more broad and vague and general sense of any "page," such as a landing page you want a visitor to see when they go to a specific "directory" on your site, which of course, in the modern web is not typically conceptualized as a "directory" but rather simply as a "page."</p> <p>So the index document has to be immediately under the same <code>/</code> delimiter and can't contain an additional <code>/</code> within its own specification.</p> <p>The index document for example.com has to be stored in example.com/index.html (assuming "index.html" is your chosen index filename) -- it has to be stored within the "directory" that it indexes, just like on a conventional web server, where, in some configurations, the web server will actually display a directory listing of files, with the "index" page replacing that directory listing in cases where the "index" page actually exists. Of course, S3 doesn't have default directory listing page functionality. </p> <p><a href="http://docs.aws.amazon.com/AmazonS3/latest/dev/IndexDocumentSupport.html" rel="noreferrer">http://docs.aws.amazon.com/AmazonS3/latest/dev/IndexDocumentSupport.html</a></p> <p>In contrast to the index document, the error document, if you configure it, is a global configuration that is used regardless of where, within the bucket, the 404 occurs, so slashes are supported in that entry. The AWS console prompts are light on hints as to the nature of the two entries, which are so different in their behavior that they arguably should be more separated, visually.</p> <hr> <p>You'll note that "sub-bucket" isn't an actual term, for what you are describing, which is an object with delimiters in its key (path), which gives the appearance of being nested under a directory or folder.</p> <p>For clarity, I have used the words "folder" and "directory" very casually all throughout this answer, with the conventional meaning... but for technical accuracy, I'll mention that S3 objects are not really stored internally in a hierarchical fashion "in directories." It appears this way, and for practical purposes, it works that way; however, it's actually the case that the <code>/</code> character, while close to being just another character in the object key, although it gets some special treatment as a delimiter because of its conventional use as a directory delimiter.Unlike some more conventional filesystems, the number of "files in each directory" does not pose any performance concern with S3 and doesn't need to be managed in the same way as is needed in a conventional filesystem when a large number of files exists, since <a href="http://aws.typepad.com/aws/2012/03/amazon-s3-performance-tips-tricks-seattle-hiring-event.html" rel="noreferrer">S3 internally hashes the key</a> ("path") of each object for its internal storage partitioning logic. </p>

Querying!

Guidance

An individual column

Larger individual text columns get their own page to allow for proper reading.

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload