クイックスタート: gsutil ツールの使用

このページでは、gsutil コマンドライン ツールを使用して Cloud Storage で基本的なタスクを実行する方法について説明します。

始める前に

  1. Google アカウントへのログイン

    Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

  2. Cloud Platform Console プロジェクトを選択または作成します。

    [プロジェクト] ページに移動

  3. プロジェクトの課金を有効にします。

    課金の有効化

  4. Cloud SDK をインストールします

    画面が表示されたら、上で作成または選択したプロジェクトを選択します。

  5. Python 2.7 をインストールします

    Windows を使用している場合は、Cloud SDK のインストールの一部としてこの処理が自動的に実行されます(Python のインストールのチェックボックスをオンのままにした場合)。

バケットの作成

  1. ターミナル ウィンドウを開きます。
  2. gsutil mb コマンドと固有の名前を使用してバケットを作成します。
    gsutil mb gs://my-awesome-bucket/
    

    これは、「my-awesome-bucket」という名前のバケットを使用します。独自のグローバルに固有なバケット名を選択する必要があります。

    成功した場合は、コマンドから次のメッセージが返されます。

    Creating gs://my-awesome-bucket/...
    
  3. バケットが作成されたので、データを保存できます。

オブジェクトのバケットへのアップロード

  1. アイコン を右クリックします。デスクトップなど、パソコン内に保存します。
  2. gsutil cp コマンドを使用して、保存したロケーションから作成したバケットにアイコンをコピーします。
    gsutil cp Desktop/cloud-storage-logo.png gs://my-awesome-bucket
    
    成功した場合は、コマンドから次のメッセージが返されます。
    Copying file://Desktop/cloud-storage-logo.png [Content-Type=image/png]...
    Uploading   gs://my-awesome-bucket/cloud-storage-logo.png:       0 B/2.58 KiB
    Uploading   gs://my-awesome-bucket/cloud-storage-logo.png:       2.58 KiB/2.58 KiB
    
    これで、オブジェクトをバケットに保存できました。

バケットからのオブジェクトのダウンロード

  1. gsutil cp コマンドを使用して、バケットに保存したアイコンをパソコンのデスクトップなどの場所にダウンロードします。
    gsutil cp gs://my-awesome-bucket/cloud-storage-logo.png Desktop
    
    成功した場合は、コマンドから次のメッセージが返されます。

    Copying gs://my-awesome-bucket/cloud-storage-logo.png...
    Downloading file://Desktop/cloud-storage-logo.png:               0 B/2.58 KiB
    Downloading file://Desktop/cloud-storage-logo.png:               2.58 KiB/2.58 KiB
    
    これで、バケットからオブジェクトをダウンロードできました。

オブジェクトのバケット内のフォルダへのコピー

  1. gsutil cp コマンドを使用して、フォルダを作成し、アイコンをその中にコピーします。

    gsutil cp gs://my-awesome-bucket/cloud-storage-logo.png gs://my-awesome-bucket/just-a-folder/
    

    成功した場合は、コマンドから次のメッセージが返されます。

    Copying gs://my-awesome-bucket/cloud-storage-logo.png [Content-Type=image/png]...
    Copying     ...my-awesome-bucket/just-a-folder/cloud-storage.logo.png: 2.58 KiB/2.58 KiB
    
    これで、オブジェクトをバケット内の新しいフォルダにコピーできました。

バケットまたはフォルダの内容の一覧表示

  1. 次のように gsutil ls コマンドを使用して、バケットの内容を一覧表示します。
    gsutil ls gs://my-awesome-bucket
    
    成功した場合は、コマンドから次のメッセージが返されます。
    gs://my-awesome-bucket/cloud-storage-logo.png
    gs://my-awesome-bucket/just-a-folder/
    
    これで、バケットの内容を表示できました。

オブジェクトの詳細の一覧表示

  1. gsutil ls コマンドと -l フラグを組み合わせて使用し、オブジェクトの詳細を取得します。
    gsutil ls -l gs://my-awesome-bucket/cloud-storage-logo.png
    
    成功した場合は、コマンドから次のメッセージが返されます。
    2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/cloud-storage-logo.png
    TOTAL: 1 objects, 2638 bytes (2.58 KiB)
    
    これで、オブジェクトのサイズと作成日に関する情報を取得できました。

オブジェクトの一般公開

  1. gsutil acl ch コマンドを使用して、バケットに保存されているオブジェクトの読み取り権限をすべてのユーザーに付与します。
    gsutil acl ch -u AllUsers:R gs://my-awesome-bucket/cloud-storage-logo.png
    
    成功した場合は、コマンドから次のメッセージが返されます。

    Updated ACL on gs://my-awesome-bucket/cloud-storage-logo.png
    
    これで、誰でもがオブジェクトを取得できるようになりました。
  2. この権限を削除するには、次のコマンドを使用します。
    gsutil acl ch -d AllUsers gs://my-awesome-bucket/cloud-storage-logo.png
    
    成功した場合は、コマンドから次のメッセージが返されます。

    Updated ACL on gs://my-awesome-bucket/cloud-storage-logo.png
    
    これで、このオブジェクトの公開アクセス権を削除できました。

バケットへのアクセス権の付与

  1. gsutil acl ch コマンドを使用して、バケットの読み取りおよび書き込み権限を特定のメールアドレスに付与します。
    gsutil acl ch -u user@gmail.com:W gs://my-awesome-bucket
    
    成功した場合は、コマンドから次のメッセージが返されます。

    Updated ACL on gs://my-awesome-bucket/
    
    ユーザーがバケット内にデータを格納したりデータを取り出したりできるようになりました。
  2. この権限を削除するには、次のコマンドを使用します。
    gsutil acl ch -d user@gmail.com gs://my-awesome-bucket
    
    成功した場合は、コマンドから次のメッセージが返されます。

    Updated ACL on gs://my-awesome-bucket/
    
    これで、このバケットへのユーザーのアクセス権を削除できました。

オブジェクトの削除

  1. gsutil rm コマンドを使用してオブジェクトを削除します。
    gsutil rm gs://my-awesome-bucket/cloud-storage-logo.png
    
    成功した場合は、コマンドから次のメッセージが返されます。
    Removing gs://my-awesome-bucket/cloud-storage-logo.png...
    
    これで、このオブジェクトのコピーは Cloud Storage に格納されなくなりました(ただし、just-a-folder/ フォルダ内に作成したコピーは引き続き存在しています)。

クリーンアップ

このチュートリアルで使用するリソースについて Google Cloud Platform アカウントに課金されないようにする手順は次のとおりです。

  1. ターミナル ウィンドウを開きます(まだ開いていない場合)。
  2. gsutil rm command-r フラグを使用して、バケットとその内容を削除します。
    gsutil rm -r gs://my-awesome-bucket
    
    成功した場合は、コマンドから次のメッセージが返されます。
    Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
    Removing gs://my-awesome-bucket/...
    
    バケットとその内容が削除されました。

次のステップ

外出先でもリソースをモニタリング

Google Cloud Console アプリを入手して、プロジェクトの管理にお役立てください。

フィードバックを送信...

Cloud Storage ドキュメント