amazon-s3 チュートリアル
amazon-s3を使い始める

備考

バージョン

S3にアクセスするためのAWS CLIのインストール

Ubuntu / Debianインスタンスにaws cliをインストールする

sudo apt-get install -y python-dev python-pip
sudo pip install awscli
aws --version
aws configure

Pythonを使ってaws cliをインストールする

あなたはWindows、OS XとLinuxでaws cliをインストールすることができますピップを使用して

sudo pip install awscli

AWSコマンドラインインターフェイスの設定

このセクションでは、セキュリティ資格やデフォルトの領域など、AWSと対話するときにAWSコマンドラインインターフェイスが使用する設定を構成する方法について説明します。

$ aws configure
AWS Access Key ID [None]: <Your access key >
AWS Secret Access Key [None]: <Your secret key>
Default region name [None]: us-west-2
Default output format [None]: json

AWSのアカウントページからアクセスキーと秘密鍵を取得する

バケットの作成

新しいバケットを作成するには、aws s3 mbコマンドを使用します。バケット名は一意でなければならず、DNSに準拠する必要があります。バケット名には小文字、数字、ハイフン、ピリオドを使用できます

aws s3 mb s3://bucket-name

バケツの取り外し

バケットを削除するには、aws s3 rbコマンドを使用します。デフォルトのバケットは空にする必要があります。

aws s3 rb s3://bucket-name

空でないバケットを削除するには、 - forceオプションを含める必要があります。

aws s3 rb s3://bucket-name --force

バケットの一覧表示

すべてのバケットまたはその内容を表示するには、aws s3 lsコマンドを使用します

aws s3 ls
aws s3 ls s3://bucket-name

次のコマンドは、バケット名/パス内のオブジェクトを一覧表示します

aws s3 ls s3://bucket-name/path

ローカルファイルシステムとS3の間でファイルを同期する

aws s3 sync . s3://my-bucket/path 

現在のディレクトリ内のすべてのファイルをS3にアップロードします。 S3から現在のディレクトリにファイルをダウンロードするには

aws s3 sync s3://my-bucket/path .

AWS CLI S3コマンドリスト

よく使用されるS3 AWS CLIコマンドのリスト

バケットの作成

aws s3 mb s3://bucket-name

バケットを取り外す

aws s3 rb s3://bucket-name

バケット一覧

aws s3 ls

バケット内の内容を一覧表示する

aws s3 ls s3://bucket-name

パス付きリストバケット

aws s3 ls s3://bucket-name/path

ファイルをコピーする

aws s3 cp file.txt s3://my-bucket/ 

ファイルを同期する

aws s3 sync . s3://my-bucket/path

ローカルファイルを削除する

rm ./MyFile1.txt

--deleteオプションなしで同期を試みる - 何も起こらない

aws s3 sync . s3://my-bucket/path

削除と同期 - オブジェクトはバケットから削除されます

aws s3 sync . s3://my-bucket/path --delete

オブジェクトをバケットから削除する

aws s3 rm s3://my-bucket/path/MySubdirectory/MyFile3.txt

削除と同期 - ローカルファイルは削除されます

aws s3 sync s3://my-bucket/path . --delete

アクセス頻度の低いストレージクラスとの同期

aws s3 sync . s3://my-bucket/path --storage-class STANDARD_IA

現在のディレクトリのMyFile.txtをs3：// my-bucket / pathにコピーします。

aws s3 cp MyFile.txt s3://my-bucket/path/

s3：// my-bucket / pathのすべての.jpgファイルを./MyDirectoryに移動します。

aws s3 mv s3://my-bucket/path ./MyDirectory --exclude '*' --include '*.jpg' --recursive

my-bucketの内容を一覧表示する

aws s3 ls s3://my-bucket

my-bucket内のpathの内容を一覧表示する

aws s3 ls s3://my-bucket/path

s3：//my-bucket/path/MyFile.txtを削除

aws s3 rm s3://my-bucket/path/MyFile.txt

s3：// my-bucket / pathとそのすべての内容を削除する

aws s3 rm s3://my-bucket/path --recursive

Javaを使用したHello Worldの例

この例では、 'hello-world'という名前のバケットを作成しようとしていますが、バケツのhello-worldは既にS3のグローバル名前空間の他の誰かによって作成されているため、次の例外がスローされます。一意の名前のバケットを作成することによって、例外を回避するために 'hello-world'を他のものに変更してください。 このように作成された新しいバケットは、AWSコンソールを使用して削除できます

スレッド "main"の例外com.amazonaws.services.s3.model.AmazonS3Exception：要求されたバケット名が使用できません。バケット名前空間は、システムのすべてのユーザーによって共有されます。別の名前を選択してもう一度お試しください。 （サービス：Amazon S3;ステータスコード：409;エラーコード：BucketAlreadyExists;リクエストID：...

           import com.amazonaws.services.s3.AmazonS3;
           import com.amazonaws.services.s3.AmazonS3ClientBuilder;
           import com.amazonaws.services.s3.model.CreateBucketRequest;
           import com.amazonaws.services.s3.model.Bucket;

            /** S3 "hello world" example. */
            public class S3Hello {

                    /** Name of hello-world bucket -- must be globally unique.  The
                     *  bucket namespace is shared by all users of the system.
                     */
                    static final String BUCKET_NAME = "hello-world";

                    /** Creates bucket
                     *  @param args Command line arguments
                     */
                    public static void main(final String[] args) {

                            AmazonS3 s3 = AmazonS3ClientBuilder.defaultClient();

                            CreateBucketRequest request
                                 = new CreateBucketRequest(BUCKET_NAME);

                            Bucket bucket = s3.createBucket(request);
                            System.out.println("S3 Hello World completed.");
                    }
            }

この例では、次の依存関係が必要です。

• コンソール操作でインストールされたJava
• AWS Java SDKがインストールされています。 https://aws.amazon.com/sdk-for-java/
• ホームディレクトリの.awsに設定された資格情報ファイルのcredentials https://aws.amazon.com/developers/getting-started/java/
• S3の管理者権限または「バケット作成権限」を持つ資格情報http://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-buckets

PowerShellを使用したHello World

この例では、hello-worldバケットがすでに存在し、S3がグローバル名前空間を使用しているため、エラーが予想されます。

    New-S3Bucket -BucketName "hello-world"

New-S3Bucket：要求されたバケット名は使用できません。バケット名前空間は、システムのすべてのユーザーによって共有されます。別の名前を選択してもう一度お試しください。

hello-worldを一意のものに置き換えると、バケットはエラーなく作成され、次の結果が得られます。

    CreationDate                                      BucketName
    ------------                                      ----------
    3/30/2017 11:43:03 PM                             hello-world-832jklsdJF

この例では、次の依存関係が必要です。

• パワーシェル。 http://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.htmlを参照してください。

• 資格情報。これらは、AWSコンソールを使用して作成できます。 PowerShellを使用してこれらを管理するには、いくつかのオプションがあります。以下はセットアップの簡単な例です。 http://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.htmlを参照してください。

    PS C:\> Set-AWSCredentials -AccessKey AKIAIOSFODNN7LAJD8A 
           -SecretKey  "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEjw9JFKS3" -StoreAs default