שינוי השם של תיקיות והעברה שלהן

בקטגוריות שבהן מופעל מרחב שמות היררכי, אפשר לשנות את השם של תיקייה או להעביר אותה בפעולה אטומית אחת. במאמר הזה מוסבר איך לשנות את השם של תיקיות או להעביר אותן.

ההוראות האלה רלוונטיות רק לתיקיות בקטגוריות שבהן מופעל מרחב שמות היררכי. בקטגוריות בלי מרחב שמות היררכי, התיקיות מדומות באמצעות קידומות של שמות אובייקטים. כדי לשנות את השם של תיקיות מדומות או להעביר אותן, קראו את המאמר שינוי השם או העברה של תיקיות מדומות.

לפני שמתחילים

מוודאים שבקטגוריה מופעל מרחב שמות היררכי. הוראות מפורטות להפעלת מרחב שמות היררכי בקטגוריה מופיעות במאמר יצירת קטגוריות עם מרחב שמות היררכי מופעל.

התפקידים הנדרשים

כדי לקבל את ההרשאות הנדרשות לשינוי שם או להעברה של תיקיות בקטגוריות, צריך לבקש מהאדמין להקצות לכם את התפקיד Storage Object User‏ (roles/storage.objectUser) ב-IAM בקטגוריה.

במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך מקצים תפקידים בקטגוריות.

כדי לראות את ההרשאות הנדרשות, מרחיבים את הקטע Required Permissions:

ההרשאות הנדרשות

• storage.folders.rename
• ההרשאה הזו נדרשת כדי לשנות את השם של תיקיית המקור.
• storage.folders.create
• ההרשאה הזו נדרשת כדי ליצור תיקייה בנתיב היעד שלה. אם משנים שם של תיקייה ומעבירים אותה לתיקיית הורה אחרת, נוצרת תיקייה במיקום החדש.

אתם יכולים לקבל את ההרשאות האלה גם באמצעות תפקידים אחרים בהתאמה אישית או תפקידים מוגדרים מראש. כדי לקבל תפקיד עם יותר הרשאות, שמאפשר לנהל תיקיות בנוסף לשינוי השם שלהן, בקשו מהאדמין להקצות לכם אחד מהתפקידים הבאים:

• אדמין של תיקיות אחסון (roles/storage.folderAdmin)
• אדמין של אובייקטים באחסון (roles/storage.objectAdmin)
• אדמין באחסון (roles/storage.admin)

במאמר תפקידי IAM ל-Cloud Storage מפורטים התפקידים השונים וההרשאות שמשויכות אליהם.

שינוי שם או העברה של תיקייה

במהלך פעולה של שינוי שם של תיקייה, אתם יכולים לקרוא את התיקיות ששמן משתנה ולהציג אותן ברשימה, אבל אתם לא יכולים להפעיל עליהן פעולות כתיבה.

המסוף

1. במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
   

   כניסה לדף Buckets

2. ברשימת הקטגוריות, לוחצים על השם של הקטגוריה שמכילה את התיקייה שרוצים להעביר או לשנות את השם שלה.

3. בדף Bucket details, בחלונית Folder browser, מאתרים את התיקייה שרוצים להעביר או לשנות את השם שלה.

4. כדי לשנות את שם התיקייה:

   1. לוחצים על תפריט הפעולות הנוספות של התיקייה.

   2. לוחצים על שינוי שם.

   3. מזינים שם חדש לתיקייה.

   4. לוחצים על שינוי שם.

5. כדי להעביר את התיקייה לתיקייה אחרת:

   1. לוחצים על תפריט הפעולות הנוספות של התיקייה.

   2. לוחצים על Move.

   3. בשדה Destination, לוחצים על Browse.

   4. בוחרים את תיקיית היעד לתיקייה שרוצים להעביר.

      אם רוצים ליצור תיקייה חדשה בתור תיקיית היעד, לוחצים על Create new folder ומזינים שם לתיקייה החדשה.

   5. לוחצים על בחירה ואז על העברה.

במאמר פתרון בעיות מוסבר איך מקבלים מידע מפורט על שגיאות בנושא פעולות ב-Cloud Storage שנכשלו במסוף Google Cloud .

שורת הפקודה

כדי לשנות את השם של תיקיות או להעביר אותן בתוך קטגוריה עם מרחב שמות היררכי, מריצים את הפקודה gcloud storage mv:

gcloud storage mv gs://BUCKET_NAME/FOLDER1 gs://BUCKET_NAME/FOLDER2

כאשר:

• ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את התיקייה שרוצים לשנות את השם שלה או להעביר אותה. לדוגמה, my-bucket.
• ‫FOLDER1 הוא השם של התיקייה המקורית שרוצים לשנות את השם שלה או להעביר אותה. לדוגמה, my-src-folder.
• ‫FOLDER2 הוא השם החדש של תיקיית היעד. לדוגמה, my-dest-folder. אם השם החדש שבחרתם כבר משמש תיקייה קיימת, התיקייה המקורית תועבר לתוך התיקייה הקיימת ותהפוך לתיקיית צאצא. לדוגמה, אם משנים את השם של my-dest-folder ל-my-dest-folder1 (והשם my-dest-folder1 כבר קיים), התוצאה היא my-dest-folder1/my-dest-folder/. אם השם החדש שבחרתם עדיין לא קיים, השם של התיקייה המקורית ישתנה לשם החדש.

התגובה אמורה להיות דומה לדוגמה הבאה:

Copying gs://my-bucket/my-src-folder to gs://my-bucket/my-dest-folder...

ספריות לקוח

C++

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C++ API.

כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& bucket_name, std::string const& source_folder_id,
   std::string const& dest_folder_id) {
  auto name = std::string{"projects/_/buckets/"} + bucket_name + "/folders/" +
              source_folder_id;
  // Start a rename operation and block until it completes. Real applications
  // may want to setup a callback, wait on a coroutine, or poll until it
  // completes.
  auto renamed = client.RenameFolder(name, dest_folder_id).get();
  if (!renamed) throw std::move(renamed).status();

  std::cout << "Renamed: " << source_folder_id << " to: " << dest_folder_id
            << "\n";
}

C#

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C# API.

כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

using Google.Cloud.Storage.Control.V2;
using System;

public class StorageControlRenameFolderSample
{
    public Folder StorageControlRenameFolder(string bucketName = "your-unique-bucket-name",
        string sourceFolderName = "your_folder_name", string targetFolderName = "target_folder_name")
    {
        StorageControlClient storageControl = StorageControlClient.Create();

        string folderResourceName =
            // Set project to "_" to signify globally scoped bucket
            FolderName.FormatProjectBucketFolder("_", bucketName, sourceFolderName);

        var operation = storageControl.RenameFolder(folderResourceName, targetFolderName);
        var folder = operation.PollUntilCompleted().Result;

        Console.WriteLine($"Renamed folder {sourceFolderName} to {targetFolderName}");
        return folder;
    }
}

Go

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Go API.

כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

import (
	"context"
	"fmt"
	"io"
	"time"

	control "cloud.google.com/go/storage/control/apiv2"
	"cloud.google.com/go/storage/control/apiv2/controlpb"
)

// renameFolder changes the name of an existing folder.
func renameFolder(w io.Writer, bucket, src, dst string) error {
	// bucket := "bucket-name"
	// src := "original-folder-name"
	// dst := "new-folder-name"

	ctx := context.Background()
	client, err := control.NewStorageControlClient(ctx)
	if err != nil {
		return fmt.Errorf("NewStorageControlClient: %w", err)
	}
	defer client.Close()

	ctx, cancel := context.WithTimeout(ctx, time.Second*30)
	defer cancel()

	// Construct source folder path including the bucket name.
	srcPath := fmt.Sprintf("projects/_/buckets/%v/folders/%v", bucket, src)

	req := &controlpb.RenameFolderRequest{
		Name:                srcPath,
		DestinationFolderId: dst,
	}
	op, err := client.RenameFolder(ctx, req)
	if err != nil {
		return fmt.Errorf("RenameFolder(%q): %w", srcPath, err)
	}

	// Wait for long-running operation to complete.
	f, err := op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("waiting for RenameFolder: %w", err)
	}

	fmt.Fprintf(w, "folder %v moved to new path %v", srcPath, f.Name)
	return nil
}

Java

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.

כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

import com.google.api.gax.longrunning.OperationFuture;
import com.google.storage.control.v2.Folder;
import com.google.storage.control.v2.FolderName;
import com.google.storage.control.v2.RenameFolderMetadata;
import com.google.storage.control.v2.RenameFolderRequest;
import com.google.storage.control.v2.StorageControlClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public final class RenameFolder {

  public static void renameFolder(
      String bucketName, String sourceFolderName, String destinationFolderName)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // The name of the bucket
    // String bucketName = "your-unique-bucket-name";

    // The name of the folder within the bucket
    // String sourceFolderName = "your-unique-source-folder-name";

    // The new name of the folder within the bucket
    // String destinationFolderName = "your-unique-destination-folder-name";

    try (StorageControlClient storageControl = StorageControlClient.create()) {

      // Set project to "_" to signify globally scoped bucket
      String sourceFolderResourceName = FolderName.format("_", bucketName, sourceFolderName);
      RenameFolderRequest request =
          RenameFolderRequest.newBuilder()
              .setName(sourceFolderResourceName)
              .setDestinationFolderId(destinationFolderName)
              .build();

      OperationFuture<Folder, RenameFolderMetadata> renameOperation =
          storageControl.renameFolderAsync(request);

      Folder destinationFolder = renameOperation.get(30, TimeUnit.SECONDS);

      System.out.printf(
          "Renamed folder from %s to %s%n", sourceFolderResourceName, destinationFolder.getName());
    }
  }
}

Node.js

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.

כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

/**
 * TODO(developer): Uncomment these variables before running the sample.
 */

// The name of your GCS bucket
// const bucketName = 'bucketName';

// The source folder name
// const sourceFolderName = 'currentFolderName';

// The destination folder ID
// const destinationFolderName = 'destinationFolderName';

// Imports the Control library
const {StorageControlClient} = require('@google-cloud/storage-control').v2;

// Instantiates a client
const controlClient = new StorageControlClient();

async function callRenameFolder() {
  const folderPath = controlClient.folderPath(
    '_',
    bucketName,
    sourceFolderName
  );

  // Create the request
  const request = {
    name: folderPath,
    destinationFolderId: destinationFolderName,
  };

  // Run request
  await controlClient.renameFolder(request);
  console.log(
    `Renamed folder ${sourceFolderName} to ${destinationFolderName}.`
  );
}

callRenameFolder();

PHP

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.

כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

use Google\Cloud\Storage\Control\V2\Client\StorageControlClient;
use Google\Cloud\Storage\Control\V2\RenameFolderRequest;

/**
 * Rename a folder in an existing bucket.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 *        (e.g. 'my-bucket')
 * @param string $sourceFolder The source folder ID.
 *        (e.g. 'my-folder')
 * @param string $destinationFolder The destination folder ID.
 *        (e.g. 'my-folder')
 */
function rename_folder(string $bucketName, string $sourceFolder, string $destinationFolder): void
{
    $storageControlClient = new StorageControlClient();

    // Set project to "_" to signify global bucket
    $formattedName = $storageControlClient->folderName('_', $bucketName, $sourceFolder);

    $request = new RenameFolderRequest([
        'name' => $formattedName,
        'destination_folder_id' => $destinationFolder,
    ]);

    $storageControlClient->renameFolder($request);

    printf('Renamed folder %s to %s', $sourceFolder, $destinationFolder);
}

Python

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Python API.

כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

from google.cloud import storage_control_v2


def rename_folder(
    bucket_name: str, source_folder_name: str, destination_folder_name: str
) -> None:
    # The ID of your GCS bucket
    # bucket_name = "your-unique-bucket-name"
    #
    # The source folder ID
    # source_folder_name = "current-folder-name"
    #
    # The destination folder ID
    # destination_folder_name = "new-folder-name"

    storage_control_client = storage_control_v2.StorageControlClient()
    # The storage bucket path uses the global access pattern, in which the "_"
    # denotes this bucket exists in the global namespace.
    source_folder_path = storage_control_client.folder_path(
        project="_", bucket=bucket_name, folder=source_folder_name
    )

    request = storage_control_v2.RenameFolderRequest(
        name=source_folder_path,
        destination_folder_id=destination_folder_name,
    )

    operation = storage_control_client.rename_folder(request=request)
    operation.result(60)

    print(f"Renamed folder {source_folder_name} to {destination_folder_name}")

Ruby

למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Ruby API.

כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

def rename_folder bucket_name:, source_folder_id:, destination_folder_id:
  # The ID of your GCS bucket
  # bucket_name = "your-unique-bucket-name"
  #
  # The source folder ID
  # source_folder_id = "current-folder-id"
  #
  # The destination folder ID, e.g. foo/bar/
  # destination_folder_id = "destination-folder-id"

  require "google/cloud/storage/control"

  storage_control = Google::Cloud::Storage::Control.storage_control

  # The storage folder path uses the global access pattern, in which the "_"
  # denotes this bucket exists in the global namespace.
  folder_path = storage_control.folder_path project: "_", bucket: bucket_name, folder: source_folder_id

  request = Google::Cloud::Storage::Control::V2::RenameFolderRequest.new name: folder_path,
                                                                         destination_folder_id: destination_folder_id

  storage_control.rename_folder request

  puts "Renamed folder #{source_folder_id} to #{destination_folder_id}"
end

Rust

use google_cloud_lro::Poller;
use google_cloud_storage::client::StorageControl;

pub async fn sample(client: &StorageControl, bucket_id: &str) -> anyhow::Result<()> {
    const ID: &str = "example-folder-id";
    const NEW_ID: &str = "renamed-folder-id";
    let folder = client
        .rename_folder()
        .set_name(format!("projects/_/buckets/{bucket_id}/folders/{ID}"))
        .set_destination_folder_id(NEW_ID)
        .poller()
        .until_done()
        .await?;
    println!("folder successfully renamed {folder:?}");
    Ok(())
}

ממשקי API בארכיטקטורת REST

‫API בפורמט JSON

1. להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת Authorization.

2. משתמשים בפקודה cURL כדי להעביר ל-API בפורמט JSON בקשה לשינוי שמות של תיקיות:

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/SOURCE_PATH/renameTo/folders/DESTINATION_PATH"

   כאשר:

   • ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את התיקייה שרוצים לשנות את השם שלה או להעביר אותה. לדוגמה, my-bucket.
   • ‫SOURCE_PATH הוא הנתיב של תיקיית המקור, בקידוד התווים שמתאימים לכתובות URL. לדוגמה, my-src-folder/ יותאם לקידודי התווים שמתאימים לכתובות URL באופן הבא: my-src-folder%2F.
   • ‫DESTINATION_PATH הוא הנתיב של תיקיית היעד, בקידוד כתובת URL. לדוגמה, my-dest-folder/ יותאם לקידודי התווים שמתאימים לכתובות URL באופן הבא: my-dest-folder%2F.

השלבים הבאים

• יצירה וניהול של תיקיות
• שימוש במרחב שמות היררכי לעומסי עבודה ב-Hadoop.

נסו בעצמכם

אנחנו ממליצים למשתמשים חדשים ב-Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של Cloud Storage בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300 $להרצה, לבדיקה ולפריסה של עומסי העבודה.

להתנסות ב-Cloud Storage בחינם