Lightsail オブジェクトストレージバケットのキー名 - Amazon Lightsail
キー名オブジェクトキーの命名のガイドラインXML 関連するオブジェクトキーの制約

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Lightsail オブジェクトストレージバケットのキー名

バケットにアップロードしたファイルは、Amazon Lightsail オブジェクトストレージサービスにオブジェクトとして保存されます。オブジェクトキー (またはキー名) によって、バケットに保存されているオブジェクトを一意に識別します。このガイドでは、Lightsail コンソールで表示されるバケットのフォルダ構造を構成するキー名とキー名のプレフィックスの概念について説明します。バケットについての詳細は、「オブジェクトストレージ」を参照してください。

キー名

Lightsail オブジェクトストレージサービスデータモデルは、ファイルシステムに表示される階層構造の代わりにフラット構造を使用します。フォルダとサブフォルダの階層はありません。ただし、 キー名のプレフィックスや区切り記号を使用して論理的な階層を暗示できます。Lightsail コンソールでは、キー名のプレフィックスを使用して、オブジェクトをフォルダ構造に表示します。

バケットに、次のようなオブジェクトキーを持つ 4 つのオブジェクトがあるとします。

  • 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 、 AWS Command Line Interface （AWS CLI）API、または を使用して表示および操作できます AWS SDKs。

オブジェクトキーの命名のガイドライン

オブジェクトキー名には任意の UTF-8 文字を使用できます。ただし、キー名に特定の文字を使用すると、一部のアプリケーションやプロトコルで問題が発生することがあります。以下のガイドラインは、、ウェブセーフ文字DNS、パーサー、およびその他の XML へのコンプライアンスを最大化するのに役立ちますAPIs。

セーフ文字

以下の文字セットは、一般的にキー名で使用しても安全です。

  • アルファベットの文字

    • 0-9

    • a～z

    • A～Z

  • 特殊文字

    • スラッシュ (/)

    • 感嘆符 (!)

    • ハイフン (-)

    • 下線 (_)

    • ピリオド (.)

    • アスタリスク (*)

    • 一重引用符 (')

    • 丸かっこ開き (()

    • 丸かっこ閉じ ())

有効なオブジェクトキー名の例を次に示します。

  • 4my-organization

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

  • videos/2014/birthday/video1.wmv

重要

オブジェクトキー名が 1 つのピリオド (.) または 2 つのピリオド (..) で終わる場合、Lightsail コンソールを使用してオブジェクトをダウンロードすることはできません。キー名が 1 つまたは 2 つのピリオドで終わるオブジェクトをダウンロードするには、Amazon S3 API、 AWS CLI、および を使用する必要があります AWS SDKs。詳細については、「バケットオブジェクトをダウンロードする」を参照してください。

特殊な処理を必要とする可能性がある文字

キー名の次の文字では、追加のコード処理が必要になる場合があり、エンURLコードまたは として参照する必要がありますHEX。これらの文字の一部は表示不可能な文字であり、ブラウザで処理されない場合があります。この場合も、特殊な処理が必要です。

  • アンパサンド ("&")

  • ドル記号 ("$")

  • ASCII 文字範囲 00～1F 16 進数 (0～31 進数) および 7F (127 進数）

  • アットマーク ("@")

  • 等号 ("=")

  • セミコロン (";")

  • コロン (":")

  • プラス記号 ("+")

  • スペース – いくつかの用途 (特に複数のスペース) では、スペースの重要なシーケンスが失われる可能性があります。

  • カンマ (",")

  • 疑問符 ("?")

使用しない方がよい文字

すべてのアプリケーションで一貫性を維持するには相当な量の特殊な処理が必要になるため、キー名には以下の文字を使用しないでください。

  • バックスラッシュ ("\")

  • 左中括弧 ("{")

  • 印刷できないASCII文字 (128～255 進数文字）

  • カレット ("^")

  • 右中括弧 ("}")

  • パーセント記号 ("%")

  • アクサングラーブ/バックティック ("`")

  • 右角括弧 ("]")

  • 引用符

  • 大なり記号 (">")

  • 左角括弧 ("[")

  • チルダ ("~")

  • 小なり記号 ("<")

  • シャープ記号 ("#")

  • 縦棒/パイプ ("|")

XML 関連するオブジェクトキーの制約

XML end-of-line の処理に関する標準で指定されているように、すべてのXMLテキストが正規化され、単一キャリッジリターン (ASCIIコード 13) とキャリッジリターンの直後にラインフィード (ASCIIコード 10) が 1 行フィード文字に置き換えられます。XML リクエスト内のオブジェクトキーを正しく解析するには、キャリッジリターンやその他の特殊文字をタグ内に挿入するときに、同等のXMLエンティティコードに置き換える必要があります。 XML以下では、当該特殊文字とそれに相当するエンティティコードのリストを示しています。

  • &apos; としての '

  • &quot; としての ”

  • &amp; としての &

  • &lt; としての <

  • &gt; としての <

  • &#13; または &#x0D; としての \r

  • &#10; または &#x0A; としての \n

次の例は、キャリッジリターンの代替として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>