KRM API object.gdc.goog/v1

object.gdc.goog/v1

כולל הגדרות סכימת API לקבוצת ה-API של Object Storage v1.

קטגוריה

הגדרת הסכימה של Buckets API.

מופיע ב: - BucketList

שדה תיאור
apiVersion string object.gdc.goog/v1
kind string Bucket
metadata ObjectMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
spec BucketSpec
status BucketStatus

BucketInfo

הגדרת הסכימה של BucketInfo API.

מופיע ב: - BucketInfoList

שדה תיאור
apiVersion string object.gdc.goog/v1
kind string BucketInfo
metadata ObjectMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
spec BucketInfoSpec
status BucketInfoStatus

BucketInfoList

מכיל רשימה של BucketInfo.

שדה תיאור
apiVersion string object.gdc.goog/v1
kind string BucketInfoList
metadata ListMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
items מערך BucketInfo

BucketInfoSpec

‫BucketInfoSpec מגדיר את המצב הרצוי של משאב BucketInfo.

מופיע ב: - BucketInfo

שדה תיאור
description string התיאור של התוכן בדלי.
storageClass ObjectStorageClass ההגדרה הזו קובעת באיזו תדירות צריך לגשת לנתונים. האפשרויות הזמינות כוללות Standard ו-Nearline. ‫Standard מתאים לנתונים פעילים שניגשים אליהם לעיתים קרובות, כמו אתרים, סרטוני וידאו בסטרימינג ואפליקציות לנייד. הוא משמש לנתונים שאפשר לאחסן למשך 30 ימים לפחות. ‫Nearline מתאים לנתונים שאפשר לאחסן למשך 60 ימים לפחות, כולל גיבוי נתונים ותוכן מולטימדיה 'זנב ארוך'.
bucketPolicy GlobalBucketPolicy הגדרת מדיניות של משאב בקטגוריה. אם לא מצוין ערך, המערכת תחיל את מדיניות ברירת המחדל.
location string המיקום הפיזי שבו נמצאים נתוני האובייקטים בקטגוריה. אם לא מציינים מיקום, ברירת המחדל היא המיקום שבו נוצרת הקטגוריה.
bucketName string השם של הקטגוריה שהוקצתה, ללא מרחב שמות. השם הזה משמש להתייחסות למאגר כשמשתמשים בספריות ובכלים מקומיים.
zonalEndpoints מערך מחרוזות נקודות קצה של DNS אזורי שדרכן אפשר להגיע לקטגוריה. משתמשים בנקודות הקצה האלה אם נדרש מעבר לגיבוי בהתאמה אישית.
globalEndpoint string נקודת קצה גלובלית שתנתב באופן דינמי תנועה לכל אזור שמכיל נתונים עבור הדלי הזה. משתמשים בנקודת הקצה הזו אם נדרש מעבר אוטומטי לגיבוי.
region string האזור שבו הקטגוריה מאוחסנת.
encryption EncryptionStatus הסטטוס של ההצפנה בדלי.
allowDegradedWrites boolean משמש רק לקטגוריות סינכרוניות. קובע אם פעולות S3 צריכות לחזור לשכפול אסינכרוני בגלל שאחד מאזורי השכפול לא זמין. כך נמנע מצב שבו קטגוריות סינכרוניות הופכות לקריאה בלבד במקרה שאחד מאזורי השכפול מושבת. אם השדה ריק, ברירת המחדל היא false.

BucketInfoStatus

הגדרה של המצב שנצפה של BucketInfo.

מופיע ב: - BucketInfo

שדה תיאור
conditions מערך Condition

BucketList

מכיל רשימה של קטגוריות.

שדה תיאור
apiVersion string object.gdc.goog/v1
kind string BucketList
metadata ListMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
‫items Bucket array

BucketPolicy

הגדרת כללי המדיניות של הקטגוריה.

מופיע ב: - BucketSpec

שדה תיאור
lockingPolicy LockingPolicy מדיניות לנעילת אובייקטים. כשמגדירים את המדיניות הזו, האפשרות 'גרסאות של אובייקטים' מופעלת וכל האובייקטים שמאוחסנים בקטגוריה כפופים למדיניות הזו. אי אפשר למחוק אובייקט נעול עד שהנעילה מסתיימת. אפשר להפעיל את ההגדרה הזו רק כשיוצרים את הקטגוריה, ואי אפשר להשבית אותה אחר כך. אם ההגדרה הזו לא מופעלת, נעילת אובייקטים וניהול גרסאות מושבתים ואי אפשר להפעיל אותם.
corsPolicy CorsPolicy מדיניות לגבי קבוצת משתמשים עם מדיניות CORS מותאמת אישית שהוגדרה בקטגוריה. צריך להפעיל את CorsPolicy כשנדרשת מדיניות CORS נוספת בדליים. אחרת, לקטגוריה תהיה רק מדיניות ברירת המחדל של CORS במסוף ממשק המשתמש. תמיד אפשר להוסיף או לשנות את CorsPolicy מאוחר יותר אחרי שהקטגוריה נוצרת.
lifecyclePolicy LifecyclePolicy מדיניות לקבוצת משתמשים עם מדיניות מותאמת אישית של מחזור חיים שהוגדרה בקטגוריה. אחרי שיוצרים את הקטגוריה, תמיד אפשר להוסיף, לשנות או להסיר את LifecyclePolicy.

BucketSpec

ההגדרה BucketSpec מגדירה את המצב הרצוי של משאב הקטגוריה.

מופיע ב: - Bucket

שדה תיאור
description string תיאור של התוכן בדלי.
storageClass ObjectStorageClass ההגדרה הזו קובעת באיזו תדירות צריך לגשת לנתונים. האפשרויות הזמינות כוללות Standard ו-Nearline. ‫Standard מתאים לנתונים פעילים שניגשים אליהם לעיתים קרובות, כמו אתרים, סרטוני וידאו בסטרימינג ואפליקציות לנייד. הוא משמש לנתונים שאפשר לאחסן למשך 30 ימים לפחות. ‫Nearline מתאים לנתונים שאפשר לאחסן למשך 60 ימים לפחות, כולל גיבוי נתונים ותוכן מולטימדיה 'זנב ארוך'.
bucketPolicy BucketPolicy הגדרת מדיניות של משאב בקטגוריה. אם לא מצוין ערך, המערכת תחיל את מדיניות ברירת המחדל.
location string המיקום הפיזי שבו נמצאים נתוני האובייקטים בקטגוריה. אם לא מציינים מיקום, ברירת המחדל היא המיקום שבו נוצרת הקטגוריה.

BucketStatus

הגדרה של המצב הנצפה של הקטגוריה.

מופיע ב: - Bucket

שדה תיאור
fullyQualifiedName string השם של הקטגוריה שהוקצתה. השם הזה משמש להתייחסות לקטגוריה כשמשתמשים בספריות ובכלים חיצוניים.
conditions מערך Condition מציין את הסטטוס של הקטגוריה. התנאים הנתמכים כוללים BucketReady. אם הערך של BucketReady הוא True, זה מציין שהוקצתה לקטגוריה הקצאת משאבים והיא מוכנה לשימוש.
endpoint string נקודת הקצה של ה-DNS שאפשר להגיע דרכה לקטגוריה.
region string האזור שבו הקטגוריה מאוחסנת.
encryption EncryptionStatus הסטטוס של ההצפנה בדלי.
errorStatus ErrorStatus השדה ErrorStatus מכיל את השגיאות האחרונות עם הזמנים שבהם הן נצפו.

CorsPolicy

הגדרת האסטרטגיה להגדרת מדיניות CORS מותאמת אישית בקטגוריה.

מופיע ב: - BucketPolicy - GlobalBucketPolicy

שדה תיאור
enableCorsPolicy boolean ההגדרה קובעת אם המשתמש רוצה שמדיניות מותאמת אישית תחול על הקטגוריה. אם כן, המדיניות המותאמת אישית שמוגדרת ב-CorsDetail תיקרא. אחרת, לא נעשה שימוש ב-CorsDetail גם אם מוגדרת מדיניות מותאמת אישית.
corsDetail CorsRule פרטים על מדיניות ה-CORS המותאמת אישית שמוגדרת.

CorsRule

הגדרת המידע שקשור לכלל CORS.

מופיע ב: - CorsPolicy

שדה תיאור
allowedHeaders מערך מחרוזות כותרות שמצוינות בכותרת Access-Control-Request-Headers.
allowedMethods מערך מחרוזות שיטות HTTP שמותר למקור מורשה להפעיל.
allowedOrigins מערך מחרוזות מקורות שיכולים לגשת לקטגוריה.
exposeHeaders מערך מחרוזות כותרות בתגובה שאפשר לגשת אליהן.
id string מזהה ייחודי של הכלל. הערך לא יכול להיות ארוך מ-255 תווים.

EncryptionStatus

השדה EncryptionStatus מגדיר את סטטוס ההצפנה בקטגוריה.

מופיע ב: - BucketInfoSpec - BucketStatus

שדה תיאור
type EncryptionType הגדרת סוג ההצפנה שבה יש להשתמש עבור הקטגוריה. האפשרויות הזמינות הן: - CMEK – מפתח הצפנה בניהול הלקוח, שיוצר מפתח שמגובה על ידי KMS ומושרש ב-HSM, והלקוח מחויב עליו. הלקוח יכול לגשת למפתחות האלה ולנהל אותם באמצעות KMS.
keyRef ObjectReference ההפניה KeyRef מתייחסת למפתח שמשמש כמפתח ברירת המחדל להצפנת אובייקטים בקטגוריה.

GlobalBucketPolicy

הגדרת כללי המדיניות של הקטגוריה.

מופיע ב: - BucketInfoSpec

שדה תיאור
lockingPolicy LockingPolicy מדיניות לנעילת אובייקטים. כשמגדירים את המדיניות הזו, האפשרות 'גרסאות של אובייקטים' מופעלת וכל האובייקטים שמאוחסנים בקטגוריה כפופים למדיניות הזו. אי אפשר למחוק אובייקט נעול עד שהנעילה מסתיימת. אפשר להפעיל את ההגדרה רק כשיוצרים את הקטגוריה, ואי אפשר להשבית אותה אחר כך.
corsPolicy CorsPolicy מדיניות לגבי קבוצת משתמשים עם מדיניות CORS מותאמת אישית שהוגדרה בקטגוריה. צריך להפעיל את CorsPolicy כשנדרשת מדיניות CORS נוספת בדליים. אחרת, לקטגוריה תהיה רק מדיניות ברירת המחדל של CORS במסוף ממשק המשתמש. תמיד אפשר להוסיף או לשנות את CorsPolicy מאוחר יותר אחרי שהקטגוריה נוצרת.
lifecyclePolicy LifecyclePolicy מדיניות לקבוצת משתמשים עם מדיניות מותאמת אישית של מחזור חיים שהוגדרה בקטגוריה. אחרי שיוצרים את הקטגוריה, תמיד אפשר להוסיף, לשנות או להסיר את LifecyclePolicy.

LifecycleExpiration

מופיע ב: - LifecycleRule

שדה תיאור
date זמן תאריך ספציפי שבו האובייקטים צריכים להימחק.
days מספר שלם מספר הימים שבהם האובייקט כפוף לכלל.

LifecycleNoncurrentExpiration

מופיע ב: - LifecycleRule

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

LifecyclePolicy

מופיע ב: - BucketPolicy - GlobalBucketPolicy

שדה תיאור
enable boolean ההגדרה קובעת אם המשתמש רוצה להפעיל מדיניות מותאמת אישית בנושא מחזור חיים בקטגוריה.
lifecycleRules מערך LifecycleRule היא מורכבת מכללים להגדרת מחזור חיים שיכולים להגדיר פעולת תפוגה לאובייקטים בקטגוריה.

LifecycleRule

מופיע ב: - LifecyclePolicy

שדה תיאור
id string מזהה ייחודי של הכלל. הערך לא יכול להיות ארוך מ-255 תווים.
status LifecycleRuleStatus הסטטוס של כלל מחזור החיים. מציינים אם הכלל הזה יבצע פעולה. תמיד אפשר לשנות את הסטטוס, ורק כלל עם הסטטוס 'מופעל' ייכנס לתוקף.
expiration LifecycleExpiration התנהגות התפוגה של אובייקטים בגרסה הנוכחית. צריך לספק את התאריך Expiration או את התאריך NoncurrentExpiration, או את שניהם. המערכת תתעלם מכלל ללא התנהגות תפוגה.
noncurrentExpiration LifecycleNoncurrentExpiration התנהגות התפוגה של אובייקטים לא עדכניים.
filter LifecycleRuleFilter מסננים את הכלל. אם לא מציינים מסנן, הכלל חל על כל האובייקטים בקטגוריה.

LifecycleRuleFilter

הגדרה של המסנן שאפשר להגדיר בכלל של מחזור החיים.

מופיע ב: - LifecycleRule

שדה תיאור
prefixFilter string התאמה לאובייקטים עם הקידומת שצוינה. מחרוזת ריקה של תחילית פירושה שההגדרה חלה על כל האובייקטים בקטגוריה.
tagFilters מערך Tag התאמה של אובייקטים לתגים שסופקו. התג באובייקט חייב להיות זהה בדיוק למפתח ולערך.

LifecycleRuleStatus

סוג בסיסי: string

מופיע ב: - LifecycleRule

LockingPolicy

הגדרת האסטרטגיה לנעילת האובייקטים של הדלי.

מופיע ב: - BucketPolicy - GlobalBucketPolicy

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

S3CredentialRotationRequest

‫S3CredentialRotationRequest הוא הסכימה של S3CredentialRotationRequests API

מופיע ב: - S3CredentialRotationRequestList

שדה תיאור
apiVersion string object.gdc.goog/v1
kind string S3CredentialRotationRequest
metadata ObjectMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
spec S3CredentialRotationRequestSpec
status S3CredentialRotationRequestStatus

S3CredentialRotationRequestList

‫S3CredentialRotationRequestList מכיל רשימה של S3CredentialRotationRequest

שדה תיאור
apiVersion string object.gdc.goog/v1
kind string S3CredentialRotationRequestList
metadata ListMeta פרטים נוספים על השדות של metadata זמינים במסמכי העזרה של Kubernetes API.
items S3CredentialRotationRequest array

S3CredentialRotationRequestSpec

‫S3CredentialRotationRequestSpec מגדיר את המצב הרצוי של S3CredentialRotationRequest. ההגדרה הזו משמשת כדי להתחיל את הרוטציה של פרטי הכניסה ל-S3 שמאוחסנים ב-Kubernetes Secret.

מופיע ב: - S3CredentialRotationRequest

שדה תיאור
secretName string SecretName הוא השם של הסוד ב-Kubernetes שמכיל את פרטי הכניסה ל-S3 שצריך להחליף. הסוד חייב להיות באותו מרחב שמות כמו S3CredentialRotationRequest.
expirationDelay משך הזמן הפרמטר ExpirationDelay מציין את משך הזמן שבו מפתח S3 הישן שעבר רוטציה יישאר בתוקף אחרי יצירת המפתח החדש. כך ניתן תקופת מעבר נוחה ללקוחות ולאפליקציות כדי לעבור לפרטי הכניסה החדשים. אם לא מציינים ערך, הוא מוגדר כברירת מחדל ל-72 שעות על ידי webhook של הגדרת ברירת מחדל. הערך '0s' מציין שצריך לבטל את המפתח הישן מיד אחרי הפעלת המפתח החדש. הפורמט הוא מחרוזת של משך זמן שאפשר לנתח באמצעות הפונקציה time.ParseDuration של Go. לדוגמה, ‎72h,‏ ‎90m,‏ ‎30s. שימו לב: אין תמיכה ביחידות כמו 'd' לימים. פרטים נוספים על הפורמט זמינים בכתובת https://pkg.go.dev/time#ParseDuration.
requestTTL משך הזמן המאפיין RequestTTL מגדיר את אורך החיים (TTL) של אובייקט S3CredentialRotationRequest עצמו. הטיימר של ה-TTL מתחיל אחרי סיום הרוטציה של פרטי הכניסה (כלומר, כשהסטטוס של RotationCompleted הופך ל-True). אחרי משך הזמן הזה, המערכת תבצע איסוף אשפה אוטומטי של אובייקט הבקשה. המנגנון הזה שומר את הבקשה כרשומה לביקורת למשך תקופה שניתנת להגדרה. אם לא מציינים ערך, הוא מוגדר כברירת מחדל ל-90 ימים על ידי webhook של ברירת מחדל. הפורמט הוא מחרוזת של משך זמן שאפשר לנתח באמצעות הפונקציה time.ParseDuration של Go. לדוגמה, ‎2160h (ל-90 ימים), ‎72h,‏ ‎30m. שימו לב: אין תמיכה ביחידות כמו d לימים. פרטים נוספים על הפורמט זמינים בכתובת https://pkg.go.dev/time#ParseDuration.

S3CredentialRotationRequestStatus

‫S3CredentialRotationRequestStatus מגדיר את המצב שנצפה של S3CredentialRotationRequest. הוא מספק משוב על ההתקדמות והתוצאה של תהליך עדכון פרטי הכניסה.

מופיע ב: - S3CredentialRotationRequest

שדה תיאור
conditions מערך Condition המאפיין Conditions מייצג את התצפיות האחרונות שזמינות לגבי מצב בקשת הרוטציה. הוא מספק פירוט של תהליך הרוטציה, כולל השלב הנוכחי ושגיאות שאולי התרחשו.
oldKeyRevocationTimestamp זמן ‫OldKeyRevocationTimestamp היא חותמת הזמן שבה מתוכננת ביטול סופי של מפתח S3 הישן שעבר רוטציה ממערכת האחסון בעורף. הזמן הזה מחושב על ידי הוספת הערך של ExpirationDelay לערך של LastTransitionTime בתנאי RotationCompleted.

תג

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

מופיע ב: - LifecycleRuleFilter

שדה תיאור
key string
value string