オブジェクトのダウンロード

このページでは、Cloud Storage のバケットからオブジェクトをダウンロードする方法について説明します。オブジェクトの概要については、主な用語をご覧ください。

Console

Google Cloud Platform Console で Cloud Storage ブラウザを開きます。
Cloud Storage ブラウザを開く
バケットのリストで、ダウンロードするオブジェクトが含まれているバケットの名前をクリックし、そのオブジェクトに移動します。
オブジェクトに関連付けられているプルダウンメニューをクリックします。

プルダウンメニューは、行の右側にある 3 個の点が縦に並んだアイコンです。
[ダウンロード] を選択します。

gsutil

gsutil cp コマンドを使用します。

gsutil cp gs://[BUCKET_NAME]/[OBJECT_NAME] [SAVE_TO_LOCATION]

ここで

[BUCKET_NAME] は、ダウンロードするオブジェクトを含むバケットの名前です。例: my-bucket。
[OBJECT_NAME] は、ダウンロードするオブジェクトの名前です。例: pets/dog.png。
[SAVE_TO_LOCATION] は、オブジェクトを保存するローカルパスです。例: Desktop/Images。

成功した場合は、次の例のようなレスポンスになります。

Operation completed over 1 objects/58.8 KiB.

コードサンプル

C++

詳細については、Cloud Storage C++ API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

namespace gcs = google::cloud::storage;
[](gcs::Client client, std::string bucket_name, std::string object_name) {
  gcs::ObjectReadStream stream = client.ReadObject(bucket_name, object_name);

  int count = 0;
  std::string line;
  while (std::getline(stream, line, '\n')) {
    ++count;
  }

  std::cout << "The object has " << count << " lines\n";
}

C#

詳細については、Cloud Storage C# API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

private void DownloadObject(string bucketName, string objectName,
    string localPath = null)
{
    var storage = StorageClient.Create();
    localPath = localPath ?? Path.GetFileName(objectName);
    using (var outputFile = File.OpenWrite(localPath))
    {
        storage.DownloadObject(bucketName, objectName, outputFile);
    }
    Console.WriteLine($"downloaded {objectName} to {localPath}.");
}

Go

詳細については、Cloud Storage Go API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

rc, err := client.Bucket(bucket).Object(object).NewReader(ctx)
if err != nil {
	return nil, err
}
defer rc.Close()

data, err := ioutil.ReadAll(rc)
if err != nil {
	return nil, err
}
return data, nil

Java

詳細については、Cloud Storage Java API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

// The name of the bucket to access
// String bucketName = "my-bucket";

// The name of the remote file to download
// String srcFilename = "file.txt";

// The path to which the file should be downloaded
// Path destFilePath = Paths.get("/local/path/to/file.txt");

// Instantiate a Google Cloud Storage client
Storage storage = StorageOptions.getDefaultInstance().getService();

// Get specific file from specified bucket
Blob blob = storage.get(BlobId.of(bucketName, srcFilename));

// Download file to specified path
blob.downloadTo(destFilePath);

Node.js

詳細については、Cloud Storage Node.js API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';
// const srcFilename = 'Remote file to download, e.g. file.txt';
// const destFilename = 'Local destination for file, e.g. ./local/path/to/file.txt';

const options = {
  // The path to which the file should be downloaded, e.g. "./file.txt"
  destination: destFilename,
};

// Downloads the file
await storage
  .bucket(bucketName)
  .file(srcFilename)
  .download(options);

console.log(
  `gs://${bucketName}/${srcFilename} downloaded to ${destFilename}.`
);

PHP

詳細については、Cloud Storage PHP API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

use Google\Cloud\Storage\StorageClient;

/**
 * Download an object from Cloud Storage and save it as a local file.
 *
 * @param string $bucketName the name of your Google Cloud bucket.
 * @param string $objectName the name of your Google Cloud object.
 * @param string $destination the local destination to save the encrypted object.
 *
 * @return void
 */
function download_object($bucketName, $objectName, $destination)
{
    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $object = $bucket->object($objectName);
    $object->downloadToFile($destination);
    printf('Downloaded gs://%s/%s to %s' . PHP_EOL,
        $bucketName, $objectName, basename($destination));
}

Python

詳細については、Cloud Storage Python API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

def download_blob(bucket_name, source_blob_name, destination_file_name):
    """Downloads a blob from the bucket."""
    storage_client = storage.Client()
    bucket = storage_client.get_bucket(bucket_name)
    blob = bucket.blob(source_blob_name)

    blob.download_to_filename(destination_file_name)

    print('Blob {} downloaded to {}.'.format(
        source_blob_name,
        destination_file_name))

Ruby

詳細については、Cloud Storage Ruby API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

# project_id  = "Your Google Cloud project ID"
# bucket_name = "Your Google Cloud Storage bucket name"
# file_name   = "Name of file in Google Cloud Storage to download locally"
# local_path  = "Destination path for downloaded file"

require "google/cloud/storage"

storage = Google::Cloud::Storage.new project_id: project_id
bucket  = storage.bucket bucket_name
file    = bucket.file file_name

file.download local_path

puts "Downloaded #{file.name}"

REST API

JSON API

OAuth 2.0 Playground から承認アクセストークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。
cURL を使用して、GET Object リクエストで JSON API を呼び出します。
```
curl -X GET \
  -H "Authorization: Bearer [OAUTH2_TOKEN]" \
  -o "[SAVE_TO_LOCATION]" \
  "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]?alt=media"
```
ここで
- [OAUTH2_TOKEN] は、ステップ 1 で生成したアクセストークンです。
- [SAVE_TO_LOCATION] は、オブジェクトを保存するローカルパスです。例: Desktop/Images。
- [BUCKET_NAME] は、ダウンロードするオブジェクトを含むバケットの名前です。例: my-bucket。
- [OBJECT_NAME] は、ダウンロードするオブジェクトの名前です。例: pets/dog.png。オブジェクト名を安全に URL エンコードする方法については、パスの URI エンコードをご覧ください。

XML API

OAuth 2.0 Playground から承認アクセストークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。
cURL を使用して、GET Object リクエストで XML API を呼び出します。
```
curl -X GET \
  -H "Authorization: Bearer [OAUTH2_TOKEN]" \
  -o "[SAVE_TO_LOCATION]" \
  "https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]"
```
ここで
- [OAUTH2_TOKEN] は、ステップ 1 で生成したアクセストークンです。
- [SAVE_TO_LOCATION] は、オブジェクトを保存するローカルパスです。例: Desktop/Images。
- [BUCKET_NAME] は、ダウンロードするオブジェクトを含むバケットの名前です。例: my-bucket。
- [OBJECT_NAME] は、ダウンロードするオブジェクトの名前です。例: pets/dog.png。

バケットまたはサブディレクトリ内のすべてのオブジェクトを簡単にダウンロードするには、gsutil cp コマンドを使用します。

次のステップ

このページは役立ちましたか？評価をお願いいたします。

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

最終更新日: 11月 22, 2019

オブジェクトのダウンロード

Console

gsutil

コードサンプル

C++

C#

Go

Java

Node.js

PHP

Python

Ruby

REST API

JSON API

XML API

次のステップ

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