Lightsail 物件儲存值區的主要名稱 - Amazon Lightsail
鍵值名稱物件索引鍵命名準則XML相關物件索引鍵約束

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Lightsail 物件儲存值區的主要名稱

您上傳到儲存貯體的檔案會以物件形式存放在 Amazon Lightsail 物件儲存服務中。物件索引鍵 (或索引鍵名稱) 可唯一識別存放於儲存貯體中的物件。本指南說明組成透過 Lightsail 主控台檢視之值區之資料夾結構的金鑰名稱和金鑰名稱前置詞的概念。如需有關儲存貯體的詳細資訊，請參閱物件儲存。

鍵值名稱

Lightsail 物件儲存服務資料模型使用扁平結構，而不是階層式結構，就像您在檔案系統中看到的那樣。沒有分階層的資料夾和子資料夾。但您可以使用索引鍵名稱字首以及分隔符號來推斷邏輯階層。Lightsail 主控台會使用索引鍵名稱前置字元，以資料夾結構顯示物件。

假設您的儲存貯體具有四個物件，其物件索引鍵如下：

  • Development/Projects.xls

  • Finance/statement1.pdf

  • Private/taxdocument.pdf

  • to-dos.doc

Lightsail 主控台會使用金鑰名稱前置字元 (Development/Finance/、和Private/) 和分隔符號 (/) 來呈現資料夾結構。to-dos.doc 索引鍵名稱沒有字首，因此其物件會直接在儲存貯體的根層級顯示。如果您在 Lightsail 主控台中瀏覽至該Development/資料夾，就會看到該Projects.xls物件。在 Finance/ 資料夾中，您會看到 statement1.pdf 物件，而在 Private/ 資料夾中，則會看到 taxdocument.pdf 物件。

Lightsail 主控台可建立資料夾，方法是以金鑰名稱前置字元和分隔符號值做為金鑰名稱來建立零位元組物件。這些資料夾物件不會出現在主控台中。但是，這些物件的行為就如同任何其他物件。您可以使用 Amazon S3 API、 AWS Command Line Interface (AWS CLI) 或來檢視和操作它們 AWS SDKs。

物件索引鍵命名準則

您可以在物件索引鍵名稱中使用任何 UTF -8 個字元。但是，在索引鍵名稱中使用特定字元可能對某些應用程式和通訊協定造成問題。下列準則可協助您最大程度地遵DNS循 Web 安全字元、XML剖析器和其他項目。APIs

安全字元

下列字元集通常可安心用於索引鍵名稱中。

  • 英數字元

    • 0-9

    • a-z

    • A-Z

  • 特殊字元

    • 正斜線 (/)

    • 驚嘆號 (!)

    • 連字號 (-)

    • 底線 (_)

    • 句號 (.)

    • 星號 (*)

    • 單引號 (')

    • 左括號 (()

    • 右括號 ())

有效的物件索引鍵名稱範例如下：

  • 4my-organization

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

  • videos/2014/birthday/video1.wmv

重要

如果物件索引鍵名稱以單一句點 (.) 或兩個句點 (..) 結尾，您就無法使用 Lightsail 主控台下載物件。若要下載金鑰名稱以一或兩個期間結尾的物件，您必須使用 Amazon S3 API AWS CLI、和 AWS SDKs。如需詳細資訊，請參閱下載儲存貯體物件。

可能需要特殊處理的字元

金鑰名稱中的下列字元可能需要額外的程式碼處理，而且可能需要URL編碼或參照為HEX。其中一部分是您的瀏覽器可能無法處理的不可列印字元，這些字元也需要特殊處理：

  • ＆ 符號 ("&")

  • 貨幣符號 ("$")

  • ASCII字元範圍介於 00—1 樓的十六進位 (0 至 31 個十進位數) 和 7F (十進位 127 位數)

  • @ 符號 ("@")

  • 等號 ("=")

  • 分號 (";")

  • 冒號 (":")

  • 加號 ("+")

  • 空格 - 在某些情況下，可能會遺失大量連續空格 (特別是多個空格)

  • 逗號 (",")

  • 問號 ("?")

需要避免的字元

請避免在索引鍵名稱中使用下列字元，因為這些字元需要經過大量的特殊處理，才能在所有應用程式之間達到一致。

  • 反斜線 ("\")

  • 左大括弧 ("{")

  • 不可列印的ASCII字元 (128 至 255 個十進位字元)

  • 插入號 ("^")

  • 右大括弧 ("}")

  • 百分比字元 ("%")

  • 重音符號/反引號 ("`")

  • 右方括號 ("]")

  • 問號

  • 「大於」符號 (">")

  • 左方括號 ("[")

  • 波狀符號 ("~")

  • 「小於」符號 ("<")

  • 井字號 ("#")

  • 垂直分隔號/縱線字元 ("|")

XML相關物件索引鍵約束

正如 end-of-line 處理標XML準所指定的那樣，所有XML文本都被標準化，以便單個回車符（字ASCII碼 13）和回車緊跟一個換行符（ASCII代碼 10）被單行換行字符替換。為了確保XML要求中物件索引鍵的正確剖析，在XML標籤中插入歸位字元和其他特殊字元時，必須以對等的XML實體程式碼取代它們。以下是此類特殊字元及其對等實體程式碼的清單：

  • ' 作為 &apos;

  • ” 作為 &quot;

  • & 作為 &amp;

  • < 作為 &lt;

  • < 作為 &gt;

  • \r 作為 &#13; 或 &#x0D;

  • \n 作為 &#10; 或 &#x0A;

下列範例說明如何使用XML實體程式碼做為歸位字元的取代。此 DeleteObjects 請求刪除具有 /some/prefix/objectwith\rcarriagereturn 索引鍵參數的物件：(其中 \r 是歸位字元)。

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