Mengupload dan mendownload objek penyimpanan dalam project
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menunjukkan cara mengupload dan mendownload objek ke dan dari bucket penyimpanan yang terisolasi dari internet Google Distributed Cloud (GDC).
Sebelum memulai
Namespace project mengelola resource bucket di server Management API. Anda
harus memiliki project untuk menggunakan bucket dan objek.
Anda juga harus memiliki izin bucket yang sesuai untuk melakukan operasi berikut. Lihat Memberikan akses bucket.
Panduan penamaan objek
Gunakan panduan berikut untuk memberi nama objek:
Gunakan karakter UTF-8 saat memberi nama objek.
Jangan menyertakan informasi identitas pribadi (PII).
Mengupload objek ke bucket penyimpanan
Konsol
Di menu navigasi, klik Object Storage.
Klik nama bucket tempat Anda ingin mengupload objek.
Opsional: Jika Anda ingin membuat folder untuk menyimpan objek, klik Buat folder > masukkan nama folder > klik Buat.
Klik Upload file secara langsung, atau buka folder yang baru saja Anda buat, lalu klik Upload file.
Pilih file yang diinginkan, lalu klik Buka.
Tunggu pesan konfirmasi bahwa upload berhasil.
CLI
Untuk mengupload objek, jalankan perintah berikut:
Perintah berikut memerlukan FULLY_QUALIFIED_BUCKET_NAME. Gunakan perintah GET atau DESCRIBE dari bagian Lihat konfigurasi bucket untuk mendapatkan nama bucket yang sepenuhnya memenuhi syarat.
Perintah berikut mengupload semua file teks dari direktori lokal ke bucket:
Untuk mengupload folder ke bucket, gunakan opsi --recursive untuk menyalin seluruh hierarki direktori. Perintah berikut mengupload hierarki direktori dir:
Lakukan upload multibagian untuk objek besar, atau gunakan upload multibagian secara otomatis saat Anda memiliki file yang akan diupload dengan ukuran lebih besar dari 15 MB.
Dalam hal ini, file akan dibagi menjadi beberapa bagian, dengan setiap bagian berukuran 15 MB.
Bagian terakhir lebih kecil. Setiap bagian diupload secara terpisah dan direkonstruksi di
tujuan saat transfer selesai.
Jika upload salah satu bagian gagal, Anda dapat memulai ulang upload tanpa memengaruhi
bagian lain yang sudah diupload.
Ada dua opsi terkait upload multipart:
--disable-multipart: menonaktifkan upload multipart untuk semua file.
--multipart-chunk-size-mb=SIZE: menetapkan ukuran
setiap bagian dari upload multipart.
File yang lebih besar dari SIZE akan otomatis diupload sebagai
multithreaded-multipart. File yang lebih kecil diupload menggunakan metode
tradisional. SIZE dalam megabyte. Ukuran potongan default adalah
15 MB. Ukuran potongan minimum yang diizinkan adalah 5 MB, dan maksimum adalah 5 GB.
Mendownload objek dari bucket penyimpanan
Konsol
Di menu navigasi, klik Object Storage.
Klik nama bucket yang berisi objek.
Centang kotak di samping nama objek yang akan didownload.
Untuk penyesuaian yang lebih besar, Anda dapat membuat AEADKey sendiri dan menggunakannya secara langsung saat mengenkripsi objek di bucket Anda. Tindakan ini memberi Anda kontrol penuh atas kunci enkripsi, sehingga menggantikan kunci default. Ikuti Membuat kunci untuk membuat AEADKey baru dan pastikan kunci tersebut berada di Namespace yang sama dengan bucket yang ingin Anda gunakan. Kemudian, setiap kali mengirim permintaan, pastikan HEADER dikonfigurasi dengan x-amz-server-side-encryption: SSE-KMS dan x-amz-server-side-encryption-aws-kms-key-id: NAMESPACE_NAME/AEADKey_NAME
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThis page details the process of uploading and downloading objects within Google Distributed Cloud (GDC) air-gapped storage buckets, requiring a project namespace and appropriate bucket permissions.\u003c/p\u003e\n"],["\u003cp\u003eObjects can be uploaded to storage buckets via the console by navigating to the Object Storage section, selecting a bucket, and using the "Upload file" function or through the CLI by using the \u003ccode\u003egdcloud storage cp\u003c/code\u003e commands, also offering multipart upload support for large files.\u003c/p\u003e\n"],["\u003cp\u003eObject naming must use UTF-8 characters and should not include personally identifiable information (PII).\u003c/p\u003e\n"],["\u003cp\u003eObjects can be downloaded from storage buckets using both the console, through the "Download" feature, and the CLI, with the \u003ccode\u003egdcloud storage cp\u003c/code\u003e command, with options to download specific versions of files.\u003c/p\u003e\n"],["\u003cp\u003eCustom AEADKeys can be created and used for object encryption, providing full control over the encryption key by setting specific headers in the request, replacing default key functionality.\u003c/p\u003e\n"]]],[],null,["# Upload and download storage objects in projects\n\nThis page shows you how to upload and download objects to and from Google Distributed Cloud (GDC) air-gapped storage buckets.\n\nBefore you begin\n----------------\n\nA project namespace manages bucket resources in the Management API server. You\nmust have a [project](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/project-management) to work with buckets and objects.\n\nYou must also have the appropriate bucket permissions to perform the following\noperation. See [Grant bucket access](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/grant-obtain-storage-access#grant_bucket_access).\n\nObject naming guidelines\n------------------------\n\nUse the following guidelines to name objects:\n\n- Use UTF-8 characters when naming objects.\n- Refrain from including any personally identifiable information (PII).\n\nUpload objects to storage buckets\n---------------------------------\n\n### Console\n\n1. In the navigation menu, click **Object Storage**.\n2. Click the name of the bucket you want to upload the object to.\n3. Optional: If you want to create a folder to store your object, click **Create folder** \\\u003e enter a folder name \\\u003e click **Create**.\n4. Click **Upload file** directly, or navigate into the folder you just created and then click **Upload file**.\n5. Select the desired file and click **Open**.\n6. Wait for the confirmation message that the upload was successful.\n\n### CLI\n\nTo upload an object, run the following commands: \n\n gdcloud storage cp \u003cvar translate=\"no\"\u003eLOCAL_PATH\u003c/var\u003e s3://\u003cvar translate=\"no\"\u003eREMOTE_PATH\u003c/var\u003e\n gdcloud storage cp s3://\u003cvar translate=\"no\"\u003eREMOTE_SOURCE_PATH\u003c/var\u003e s3://\u003cvar translate=\"no\"\u003eREMOTE_MOVE_DESTINATION_PATH\u003c/var\u003e\n gdcloud storage mv s3://\u003cvar translate=\"no\"\u003eREMOTE_SOURCE_PATH\u003c/var\u003e s3://\u003cvar translate=\"no\"\u003eREMOTE_MOVE_DESTINATION_PATH\u003c/var\u003e\n\nThe following commands require the \u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e. Use the `GET` or `DESCRIBE` command from the [View bucket configuration](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/list-view-storage-buckets#view_bucket_configurations) section to get the fully qualified bucket name.\n\nThe following command uploads all text files from the local directory to a bucket: \n\n gdcloud storage cp *.txt s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e\n\nThe following command uploads multiple files from the local directory to a bucket: \n\n gdcloud storage cp abc1.txt abc2.txt s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e\n\nTo upload a folder to a bucket, use the --recursive option to copy an entire directory tree. The following command uploads the directory tree dir: \n\n gdcloud storage cp dir s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e --recursive\n\nPerform multipart uploads for large objects, or use multipart\nuploads automatically when you have a file to upload that is larger than 15 MB.\nIn that case, the file splits into multiple parts, with each part being 15 MB in size.\nThe last part is smaller. Each part uploads separately and reconstructs at\nthe destination when the transfer completes.\n\nIf an upload of one part fails, you can restart the upload without affecting any\nof the other parts already uploaded.\n\nThere are two options related to multipart uploads:\n\n- `--disable-multipart`: disables multipart uploads for all files.\n- `--multipart-chunk-size-mb=`\u003cvar translate=\"no\"\u003eSIZE\u003c/var\u003e: sets the size of each chunk of a multipart upload.\n\nFiles bigger than \u003cvar translate=\"no\"\u003eSIZE\u003c/var\u003e automatically upload as\nmultithreaded-multipart. Smaller files upload using the traditional\nmethod. \u003cvar translate=\"no\"\u003eSIZE\u003c/var\u003e is in megabytes. The default chunk size is\n15 MB. The minimum allowed chunk size is 5 MB, and the maximum is 5 GB.\n\nDownload objects from storage buckets\n-------------------------------------\n\n### Console\n\n1. In the navigation menu, click **Object Storage**.\n2. Click the name of the bucket containing the objects.\n3. Select the checkbox next to the name of the object to download.\n4. Click **Download**.\n\n### CLI\n\nTo get objects from the bucket: \n\n gdcloud storage cp s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e/\u003cvar translate=\"no\"\u003eOBJECT\u003c/var\u003e \u003cvar translate=\"no\"\u003eLOCAL_FILE_TO_SAVE\u003c/var\u003e\n\nTo download all text files from a bucket to your current directory: \n\n gdcloud storage cp s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e/*.txt .\n\nTo download the text file `abc.txt` from a bucket to your current directory: \n\n gdcloud storage cp s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e/abc.txt .\n\nTo download an older version of the file, list all versions of the file first: \n\n gdcloud storage ls s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e/abc.txt --all-versions\n\nExample output: \n\n s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND\n s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND\n s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3\n\nThen, download a specific version of the text file `abc.txt` from the bucket to your current directory: \n\n gdcloud storage cp s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .\n\nUse custom AEADKey\n------------------\n\nFor greater customization, you can create your own AEADKey and use it directly when encrypting objects in your bucket. This gives you full control over the encryption key, bypassing the default. Follow [Create a key](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/kms/create-delete-keys#create) to create a new AEADKey and make sure it's in the same `Namespace` as the bucket you intend to use. Then, whenever sending the request, make sure the `HEADER` is configured with `x-amz-server-side-encryption: SSE-KMS` and `x-amz-server-side-encryption-aws-kms-key-id: `\u003cvar translate=\"no\"\u003eNAMESPACE_NAME\u003c/var\u003e`/`\u003cvar translate=\"no\"\u003eAEADKey_NAME\u003c/var\u003e"]]
