שימוש בהקשרים של אובייקטים

המסוף

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

   כניסה לדף Buckets

2. העלאת האובייקט.

3. פועלים לפי השלבים לצירוף הקשרים לאובייקט.

שורת הפקודה

כדי לצרף הקשרים כשמעלים אובייקטים באמצעות הפקודה gcloud storage cp, משתמשים בדגל --custom-contexts:

gcloud storage cp OBJECT_LOCATION gs://DESTINATION_BUCKET_NAME --custom-contexts=KEY=VALUE,...

כאשר:

• ‫OBJECT_LOCATION הוא הנתיב המקומי לאובייקט. לדוגמה, Desktop/employees.txt.
• ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה מעלים את האובייקט. לדוגמה, my-bucket.
• ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך ולהפריד ביניהם באמצעות פסיקים.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

אפשר גם ליצור קובץ JSON שמכיל את ההקשרים שרוצים לצרף לאובייקטים, ולהשתמש בדגל --custom-contexts-file:

  {
    "KEY": {
      "value": "VALUE"
    },
    ...
  }

כאשר:

• ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

כדי לצרף הקשרים כשמעלים ספריות באמצעות הפקודה gcloud storage rsync, משתמשים בדגל --custom-contexts או בדגל --custom-contexts-file:

gcloud storage rsync DIRECTORY_LOCATION gs://DESTINATION_BUCKET_NAME --recursive --custom-contexts=KEY=VALUE,...

כאשר:

• ‫DIRECTORY_LOCATION הוא הנתיב המקומי לספרייה. לדוגמה, ~/my_directory.
• ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה מעלים את הספרייה. לדוגמה, my-bucket.
• ‫KEY הוא מפתח ההקשר לצירוף לאובייקטים. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך ולהפריד ביניהם באמצעות פסיקים.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

‫API בפורמט JSON

כדי לצרף הקשרים לאובייקטים כשמעלים אובייקטים חדשים, אפשר להשתמש בכל אחת מהשיטות הבאות:

• העלאות מרובות חלקים

• העלאות שניתן להמשיך

כחלק מהמטא-נתונים של האובייקט בפורמט JSON, כוללים את השדה contexts:

  {
    "contexts": {
      "custom": {
        "KEY": {
          "value": "VALUE"
        },
        ...
      }
    }
  }

כאשר:

• ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך באובייקט custom.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

המסוף

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

   כניסה לדף Buckets

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

3. עוברים לאובייקט ולוחצים על more_vert אפשרויות נוספות של האובייקט.

4. לוחצים על עריכת ההקשרים.

5. בחלונית עריכת הקשרים, מבצעים אחת מהפעולות הבאות:

   • הוספת הקשר אובייקט חדש:

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

     2. בשדות Object context key ו-Object context value, מזינים צמד חדש של מפתח וערך.

     3. לוחצים על סיום.

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

   • כדי לערוך הקשר של אובייקט:

     1. לוחצים על ההקשר של האובייקט.

     2. מעדכנים את השדה Object context key (מפתח הקשר של האובייקט), את השדה Object context value (ערך ההקשר של האובייקט) או את שניהם.

     3. לוחצים על סיום ואז על שמירה.

   • מחיקת הקשר של אובייקט:

     לוחצים על delete מחיקה ואז על שמירה.

שורת הפקודה

משתמשים בפקודה gcloud storage objects update:

gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME CUSTOM_CONTEXTS_FLAG

כאשר:

• ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים לערוך את ההקשר שלו. לדוגמה, my-bucket.
• ‫OBJECT_NAME הוא שם האובייקט. לדוגמה, employees.txt.

• ‫CUSTOM_CONTEXTS_FLAG הוא אחד מהדגלים הבאים:

  • כדי להחליף את כל ההקשרים הקיימים, משתמשים בפקודה --custom-contexts=KEY=VALUE,... או בפקודה --custom-contexts-file=CUSTOM_CONTEXTS_FILE

    כאשר:

    • ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך ולהפריד ביניהם באמצעות פסיקים.
    • ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.
    • ‫CUSTOM_CONTEXTS_FILE הוא הנתיב לקובץ JSON או YAML שמכיל את ההקשרים שרוצים לצרף לאובייקט.

  • כדי למחוק את כל ההקשרים הקיימים, משתמשים בדגל --clear-custom-contexts.

  • כדי להוסיף, לשנות או למחוק הקשרים ספציפיים, משתמשים בשילוב של --update-custom-contexts=KEY=VALUE,... ו---remove-custom-contexts=KEY,...

    כאשר:

    • ‫KEY הוא מפתח ההקשר שרוצים לצרף לאובייקט או למחוק ממנו. לדוגמה, Department.
    • ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר שרוצים לצרף לאובייקט או למחוק ממנו. לדוגמה, Human resources.

אם הפעולה בוצעה ללא שגיאות, התשובה תיראה כמו בדוגמה הבאה:

Patching gs://my-bucket/employees.txt#1560574162144861...
  Completed 1

ספריות לקוח

import com.google.cloud.storage.Blob;
import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.BlobInfo;
import com.google.cloud.storage.BlobInfo.ObjectContexts;
import com.google.cloud.storage.BlobInfo.ObjectCustomContextPayload;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;
import com.google.common.collect.Maps;
import java.util.Map;

public class SetObjectContexts {
  public static void setObjectContexts(
      String projectId, String bucketName, String objectName, String key, String value)
      throws Exception {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    // The ID of your GCS object
    // String objectName = "your-object-name";

    // The context key-value you want to add
    // String key = "your-context-key";
    // String value = "your-context-value";

    try (Storage storage =
        StorageOptions.newBuilder().setProjectId(projectId).build().getService()) {
      BlobId blobId = BlobId.of(bucketName, objectName);
      Blob blob = storage.get(blobId);
      if (blob == null) {
        System.out.println("The object " + objectName + " was not found in " + bucketName);
        return;
      }

      // Recommended: Set a generation-match precondition to avoid potential race
      // conditions and data corruptions. The request to update returns a 412 error if
      // the object's generation number does not match your precondition.
      Storage.BlobTargetOption precondition = Storage.BlobTargetOption.generationMatch();

      // This section demonstrates how to upsert, delete all, and delete a specific context.

      // To upsert a context (if the key already exists, its value is replaced;
      // otherwise, a new key-value pair is added):
      ObjectCustomContextPayload payload =
          ObjectCustomContextPayload.newBuilder().setValue(value).build();
      Map<String, ObjectCustomContextPayload> custom = Maps.newHashMap();
      custom.put(key, payload);
      ObjectContexts contexts = ObjectContexts.newBuilder().setCustom(custom).build();

      /*
       * To delete all existing contexts:
       * ObjectContexts contexts = ObjectContexts.newBuilder().setCustom(null).build();
       */

      /*
       * To delete a specific key from the context:
       * Map<String, ObjectCustomContextPayload> custom = Maps.newHashMap();
       * custom.put(key, null);
       * ObjectContexts contexts = ObjectContexts.newBuilder().setCustom(custom).build();
       */
      BlobInfo pendingUpdate = blob.toBuilder().setContexts(contexts).build();
      storage.update(pendingUpdate, precondition);

      System.out.println(
          "Updated custom contexts for object " + objectName + " in bucket " + bucketName);
    }
  }
}

use google_cloud_storage::client::StorageControl;
use google_cloud_storage::model::ObjectContexts;
use google_cloud_wkt::FieldMask;

pub async fn sample(client: &StorageControl, bucket_id: &str) -> anyhow::Result<()> {
    const NAME: &str = "object-with-contexts";
    let object = client
        .get_object()
        .set_bucket(format!("projects/_/buckets/{bucket_id}"))
        .set_object(NAME)
        .send()
        .await?;

    let metageneration = object.metageneration;
    let mut custom = object.contexts.clone().unwrap_or_default().custom;
    custom.entry("example".to_string()).or_default().value = "true".into();

    let updated = client
        .update_object()
        .set_if_metageneration_match(metageneration)
        .set_object(object.set_contexts(ObjectContexts::new().set_custom(custom)))
        .set_update_mask(FieldMask::default().set_paths(["contexts.custom.example"]))
        .send()
        .await?;
    println!(
        "successfully set contexts for object {NAME} in bucket {bucket_id}: {:?}",
        updated.contexts
    );
    Ok(())
}

‫API בפורמט JSON

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

2. יוצרים קובץ JSON עם ההגדרות של האובייקט, שחייבות לכלול את שדות ההגדרות contexts של האובייקט.

   כדי להוסיף, לשנות או להחליף הקשרים קיימים, צריך להשתמש בפורמט הבא:

     {
       "contexts": {
         "custom": {
           "KEY": {
             "value": "VALUE"
           },
           ...
         }
       }
     }

   כאשר:

   • ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך באובייקט custom.
   • ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

   כדי למחוק את כל ההקשרים הקיימים, משתמשים בפורמט הבא:

     {
       "contexts": {
         "custom": null
       }
     }

   כדי למחוק מפתח ספציפי מההקשר, צריך להשתמש בפורמט הבא:

     {
       "contexts": {
         "custom": {
           "KEY": null,
           ...
         }
       }
     }

   כאשר:

   ‫KEY הוא מפתח ההקשר שרוצים למחוק מאובייקט. לדוגמה, Department. אפשר לציין כמה מפתחות למחיקה מהאובייקט custom.

3. משתמשים ב- cURL כדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של אובייקט PATCH:

   curl -X PATCH --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"

   כאשר:

   • ‫JSON_FILE_NAME הוא הנתיב לקובץ שכולל את פרטי ההקשר של האובייקט.
   • ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים לערוך את ההקשר שלו. לדוגמה, my-bucket.
   • ‫OBJECT_NAME הוא שם האובייקט עם קידוד כתובת URL. לדוגמה, employees.txt.

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

המסוף

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

   כניסה לדף Buckets

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

3. עוברים לאובייקט ולוחצים על השם שלו.

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

שורת הפקודה

משתמשים בפקודה gcloud storage objects describe:

gcloud storage objects describe gs://BUCKET_NAME/OBJECT_NAME

כאשר:

• ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים לצפות בהקשר שלו. לדוגמה, my-bucket.
• ‫OBJECT_NAME הוא שם האובייקט שרוצים לצפות בהקשר שלו. לדוגמה, employees.txt.

אם הפעולה בוצעה ללא שגיאות, התגובה תיראה דומה לדוגמה הבאה:

bucket: my-bucket
contexts:
  Department:
    createTime: '2023-01-01T00:00:00.000000+00:00'
    type: CUSTOM
    updateTime: '2023-01-01T00:00:00.000000+00:00'
    value: Human resources
name: employees.txt

ספריות לקוח

import com.google.cloud.storage.Blob;
import com.google.cloud.storage.BlobInfo.ObjectContexts;
import com.google.cloud.storage.BlobInfo.ObjectCustomContextPayload;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;
import java.util.Map;

public class GetObjectContexts {
  public static void getObjectContexts(String projectId, String bucketName, String objectName)
      throws Exception {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    // The ID of your GCS object
    // String objectName = "your-object-name";

    try (Storage storage =
        StorageOptions.newBuilder().setProjectId(projectId).build().getService()) {

      Blob blob = storage.get(bucketName, objectName);
      if (blob == null) {
        System.out.println("The object " + objectName + " was not found in " + bucketName);
        return;
      }
      ObjectContexts objectContexts = blob.getContexts();

      if (objectContexts != null) {
        Map<String, ObjectCustomContextPayload> customContexts = objectContexts.getCustom();
        if (customContexts == null) {
          System.out.println("No custom contexts found for object: " + objectName);
          return;
        }
        // Print blob's object contexts
        System.out.println("\nCustom Contexts:");
        for (Map.Entry<String, ObjectCustomContextPayload> custom : customContexts.entrySet()) {
          System.out.println(custom.getKey() + "=" + custom.getValue());
        }
      }
    }
  }
}

use google_cloud_storage::client::StorageControl;

pub async fn sample(client: &StorageControl, bucket_id: &str) -> anyhow::Result<()> {
    const NAME: &str = "object-with-contexts";
    let object = client
        .get_object()
        .set_bucket(format!("projects/_/buckets/{bucket_id}"))
        .set_object(NAME)
        .send()
        .await?;
    println!(
        "The contexts field for object {NAME} in bucket {bucket_id} is: {:?}",
        object.contexts
    );
    Ok(())
}

‫API בפורמט JSON

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

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

   curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"

   כאשר:

   • ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים לצפות בהקשר שלו. לדוגמה, my-bucket.
   • ‫OBJECT_NAME הוא השם של האובייקט שרוצים לצפות בהקשר שלו, בקידודי תווים שמתאימים לכתובות URL. לדוגמה, employees.txt.

   אם הפעולה בוצעה ללא שגיאות, התגובה תיראה דומה לדוגמה הבאה:

     {
       "kind": "storage#object",
       "name": "employees.txt",
       "bucket": "my-bucket",
       "contexts": {
         "custom": {
           "Department": {
             "value": "Human resources",
             "createTime": "2023-01-01T00:00:00.000Z",
             "updateTime": "2023-01-01T00:00:00.000Z"
           }
         }
       }
     }
     

שורת הפקודה

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

• הדגל --custom-contexts להגדרת הקשרים החדשים של אובייקט היעד.

• הדגל --clear-custom-contexts כדי למנוע צירוף הקשרים מאובייקט המקור לאובייקט היעד.

• שילוב של הדגלים --update-custom-contexts ו---remove-custom-contexts כדי לשנות הקשרים ספציפיים מאובייקט המקור לפני שמצרפים אותם לאובייקט היעד.

כדי להגדיר הקשרים חדשים כשמעתיקים אובייקט, משתמשים בפקודה gcloud storage cp:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --custom-contexts=KEY=VALUE,...

כאשר:

• ‫SOURCE_BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים להעתיק. לדוגמה, my-source-bucket.
• ‫SOURCE_OBJECT_NAME הוא שם האובייקט שרוצים להעתיק. לדוגמה, employees.txt.
• ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה רוצים להעתיק את האובייקט. לדוגמה, my-destination-bucket.
• ‫DESTINATION_OBJECT_NAME הוא שם אובייקט היעד. לדוגמה, employees-backup.txt.
• ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך ולהפריד ביניהם באמצעות פסיקים.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

כדי להסיר את כל ההקשרים מאובייקט המקור כשמעתיקים אובייקט, משתמשים בפקודה gcloud storage cp:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --clear-custom-contexts

כאשר:

• ‫SOURCE_BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים להעתיק. לדוגמה, my-source-bucket.
• ‫SOURCE_OBJECT_NAME הוא שם האובייקט שרוצים להעתיק. לדוגמה, pets/dog.png.
• ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה רוצים להעתיק את האובייקט. לדוגמה, my-destination-bucket.
• ‫DESTINATION_OBJECT_NAME הוא שם אובייקט היעד. לדוגמה, pets/cat.png.

כדי לשנות הקשרים ספציפיים מאובייקט המקור כשמעתיקים אובייקט, משתמשים בפקודה gcloud storage cp עם --update-custom-contexts ו---remove-custom-contexts:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --update-custom-contexts=KEY=VALUE,... --remove-custom-contexts=KEY,...

כאשר:

• ‫SOURCE_BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים להעתיק. לדוגמה, my-source-bucket.
• ‫SOURCE_OBJECT_NAME הוא שם האובייקט שרוצים להעתיק. לדוגמה, pets/dog.png.
• ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה רוצים להעתיק את האובייקט. לדוגמה, my-destination-bucket.
• ‫DESTINATION_OBJECT_NAME הוא שם אובייקט היעד. לדוגמה, pets/cat.png.
• ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך או מפתחות שמופרדים באמצעות פסיקים.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

‫API בפורמט JSON

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

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

2. יוצרים קובץ JSON שמכיל את ההקשרים לצירוף לאובייקט היעד:

     {
       "contexts": {
         "custom": {
           "KEY": {
             "value": "VALUE"
           }
         }
       }
     }

   כאשר:

   • ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department.
   • ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

3. משתמשים ב- cURL כדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשת POSTאובייקט:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/copyTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME"

   כאשר:

   • ‫JSON_FILE_NAME הוא הנתיב לקובץ ה-JSON שכולל את פרטי ההקשר של האובייקט.
   • ‫SOURCE_BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים להעתיק. לדוגמה, my-source-bucket.
   • ‫SOURCE_OBJECT_NAME הוא השם של האובייקט שרוצים להעתיק, בקידוד התווים שמתאימים לכתובות URL. לדוגמה, employees.txt.
   • ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה רוצים להעתיק את האובייקט. לדוגמה, my-destination-bucket.
   • ‫DESTINATION_OBJECT_NAME הוא השם בקידוד כתובת URL של אובייקט היעד. לדוגמה, employees-backup.txt.

כדי להסיר את כל הקשרים של המקור בלי לספק החלפה, משתמשים בפרמטר השאילתה dropContextGroups=custom בבקשה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/copyTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME?dropContextGroups=custom"

כדי לשמור על ההקשרים, משמיטים את המאפיין contexts.custom מגוף הבקשה ומוציאים את dropContextGroups=custom מהפרמטרים של השאילתה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/copyTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME"

מידע על אופן הפעולה של ההקשרים במהלך פעולות העתקה מופיע בפרמטר השאילתה dropContextGroups.

שורת הפקודה

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

• הדגל --custom-contexts להגדרת הקשרים החדשים של אובייקט היעד.

• הדגל --clear-custom-contexts כדי למנוע צירוף הקשרים מאובייקט המקור לאובייקט היעד.

• שילוב של הדגלים --update-custom-contexts ו---remove-custom-contexts כדי לשנות הקשרים ספציפיים מאובייקט המקור לפני שמצרפים אותם לאובייקט היעד.

כדי להגדיר הקשרים חדשים כשמעתיקים אובייקט, משתמשים בפקודה gcloud storage cp:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --custom-contexts=KEY=VALUE,...

כאשר:

• ‫SOURCE_BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים להעתיק. לדוגמה, my-source-bucket.
• ‫SOURCE_OBJECT_NAME הוא שם האובייקט שרוצים להעתיק. לדוגמה, employees.txt.
• ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה רוצים להעתיק את האובייקט. לדוגמה, my-destination-bucket.
• ‫DESTINATION_OBJECT_NAME הוא שם אובייקט היעד. לדוגמה, employees-backup.txt.
• ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך ולהפריד ביניהם באמצעות פסיקים.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

כדי להסיר את כל ההקשרים מאובייקט המקור כשמעתיקים אובייקט, משתמשים בפקודה gcloud storage cp:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --clear-custom-contexts

כאשר:

• ‫SOURCE_BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים להעתיק. לדוגמה, my-source-bucket.
• ‫SOURCE_OBJECT_NAME הוא שם האובייקט שרוצים להעתיק. לדוגמה, pets/dog.png.
• ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה רוצים להעתיק את האובייקט. לדוגמה, my-destination-bucket.
• ‫DESTINATION_OBJECT_NAME הוא שם אובייקט היעד. לדוגמה, pets/cat.png.

כדי לשנות הקשרים ספציפיים מאובייקט המקור כשמעתיקים אובייקט, משתמשים בפקודה gcloud storage cp עם --update-custom-contexts ו---remove-custom-contexts:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --update-custom-contexts=KEY=VALUE,... --remove-custom-contexts=KEY,...

כאשר:

• ‫SOURCE_BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים להעתיק. לדוגמה, my-source-bucket.
• ‫SOURCE_OBJECT_NAME הוא שם האובייקט שרוצים להעתיק. לדוגמה, pets/dog.png.
• ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה רוצים להעתיק את האובייקט. לדוגמה, my-destination-bucket.
• ‫DESTINATION_OBJECT_NAME הוא שם אובייקט היעד. לדוגמה, pets/cat.png.
• ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך או מפתחות שמופרדים באמצעות פסיקים.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

‫API בפורמט JSON

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

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

2. יוצרים קובץ JSON שמכיל את ההקשרים לצירוף לאובייקט היעד:

     {
       "contexts": {
         "custom": {
           "KEY": {
             "value": "VALUE"
           }
         }
       }
     }

   כאשר:

   • ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department.
   • ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

3. משתמשים ב- cURL כדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של אובייקט POST rewrite:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/rewriteTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME"

   כאשר:

   • ‫JSON_FILE_NAME הוא הנתיב לקובץ ה-JSON שכולל את פרטי ההקשרים של האובייקט.
   • ‫SOURCE_BUCKET_NAME הוא שם הקטגוריה שמכילה את האובייקט שרוצים לכתוב מחדש. לדוגמה, my-source-bucket.
   • ‫SOURCE_OBJECT_NAME הוא השם בקידוד כתובת URL של האובייקט שכותבים מחדש. לדוגמה, employees.txt.
   • ‫DESTINATION_BUCKET_NAME הוא שם הקטגוריה שאליה רוצים לכתוב מחדש את האובייקט. לדוגמה, my-destination-bucket.
   • ‫DESTINATION_OBJECT_NAME הוא השם בקידוד כתובת URL של אובייקט היעד. לדוגמה, employees-backup.txt.

כדי להסיר את כל הקשרים של המקור בלי לספק החלפה, משתמשים בפרמטר השאילתה dropContextGroups=custom בבקשה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/rewriteTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME?dropContextGroups=custom"

כדי לשמור על ההקשרים, משמיטים את המאפיין contexts.custom מגוף הבקשה ומוציאים את dropContextGroups=custom מפרמטרים של שאילתות:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/rewriteTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME"

מידע על אופן הפעולה של הקשרים במהלך פעולות שכתוב מופיע בפרמטר השאילתה dropContextGroups.

שורת הפקודה

כדי לציין הקשרים חדשים לאובייקט היעד כשיוצרים אובייקטים, משתמשים בדגל --contexts:

gcloud storage objects compose gs://BUCKET_NAME/SOURCE_OBJECT_1 gs://BUCKET_NAME/SOURCE_OBJECT_2 gs://BUCKET_NAME/DESTINATION_OBJECT_NAME --contexts=KEY=VALUE,...

כאשר:

• ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את אובייקטי המקור ושבה נוצר אובייקט היעד. לדוגמה, my-bucket.
• ‫SOURCE_OBJECT_1 ו-SOURCE_OBJECT_2 הם אובייקטי המקור שמהם מורכב האובייקט.
• ‫DESTINATION_OBJECT_NAME הוא השם של אובייקט היעד שייווצר. לדוגמה, my-composite-object.
• ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department. אפשר לציין כמה צמדים של מפתח/ערך ולהפריד ביניהם באמצעות פסיקים.
• ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה: Human resources.

כדי למנוע צירוף של הקשרים של המקור לאובייקטים מורכבים, משתמשים בדגל --clear-custom-contexts:

gcloud storage objects compose gs://BUCKET_NAME/SOURCE_OBJECT_1 gs://BUCKET_NAME/SOURCE_OBJECT_2 gs://BUCKET_NAME/DESTINATION_OBJECT_NAME --clear-custom-contexts

כאשר:

• ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את אובייקטי המקור ושבה נוצר אובייקט היעד. לדוגמה, my-bucket.
• ‫SOURCE_OBJECT_1 ו-SOURCE_OBJECT_2 הם אובייקטי המקור שמהם מורכב האובייקט.
• ‫DESTINATION_OBJECT_NAME הוא השם של אובייקט היעד שייווצר. לדוגמה, my-composite-object.

‫API בפורמט JSON

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

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

2. יוצרים קובץ JSON שמכיל את גוף הבקשה:

   {
     "sourceObjects": [
       {"name": "SOURCE_OBJECT_1"},
       {"name": "SOURCE_OBJECT_2"}
     ],
     "destination": {
       "contentType": "text/plain",
       "contexts": {
         "custom": {
           "KEY": {
             "value": "VALUE"
           }
         }
       }
     }
   }

   כאשר:

   • ‫SOURCE_OBJECT_1 ו-SOURCE_OBJECT_2 הם אובייקטי מקור להרכבה.
   • ‫KEY הוא מפתח ההקשר לצירוף לאובייקט. לדוגמה, Department.
   • ‫VALUE הוא הערך שרוצים לשייך למפתח ההקשר. לדוגמה, Human resources.

3. משתמשים ב- cURL כדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של POST אובייקט ליצירת אימייל:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/DESTINATION_OBJECT_NAME/compose"

   כאשר:

   • ‫JSON_FILE_NAME הוא הנתיב לקובץ JSON שכולל את תוכן הבקשה.
   • ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את אובייקטי המקור ושבה ייווצר אובייקט היעד. לדוגמה, my-bucket.
   • ‫DESTINATION_OBJECT_NAME הוא השם של אובייקט היעד שייווצר. לדוגמה, my-composite-object.

כדי למנוע צירוף של הקשרים של המקור לאובייקטים מורכבים, משתמשים בפרמטר השאילתה dropContextGroups=custom בבקשה:

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

2. יוצרים קובץ JSON שמכיל את גוף הבקשה:

   {
     "sourceObjects": [
       {"name": "SOURCE_OBJECT_1"},
       {"name": "SOURCE_OBJECT_2"}
     ],
     "destination": {
       "contentType": "text/plain"
   }
   }

   כאשר:

   • ‫SOURCE_OBJECT_1 ו-SOURCE_OBJECT_2 הם אובייקטי מקור להרכבה.

3. משתמשים ב- cURL כדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של POST אובייקט ליצירת אימייל:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/DESTINATION_OBJECT_NAME/compose?dropContextGroups=custom"

   כאשר:

   • ‫JSON_FILE_NAME הוא הנתיב לקובץ JSON שכולל את תוכן הבקשה.
   • ‫BUCKET_NAME הוא שם הקטגוריה שמכילה את אובייקטי המקור ושבה ייווצר אובייקט היעד. לדוגמה, my-bucket.
   • ‫DESTINATION_OBJECT_NAME הוא השם של אובייקט היעד שייווצר. לדוגמה, my-composite-object.