REST Resource: alerts

সম্পদ: সতর্কতা

একটি গ্রাহক প্রভাবিত একটি সতর্কতা.

JSON প্রতিনিধিত্ব
{
  "customerId": string,
  "alertId": string,
  "createTime": string,
  "startTime": string,
  "endTime": string,
  "type": string,
  "source": string,
  "data": {
    "@type": string,
    field1: ...,
    ...
  },
  "securityInvestigationToolLink": string,
  "deleted": boolean,
  "metadata": {
    object (AlertMetadata)
  },
  "updateTime": string,
  "etag": string
}
ক্ষেত্র
customerId

string

শুধুমাত্র আউটপুট। গ্রাহকের Google Workspace অ্যাকাউন্টের অনন্য শনাক্তকারী।

alertId

string

শুধুমাত্র আউটপুট। সতর্কতার জন্য অনন্য শনাক্তকারী।

createTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময় এই সতর্কতা তৈরি করা হয়েছিল।

startTime

string ( Timestamp format)

প্রয়োজন। যে সময় এই সতর্কতা সৃষ্টিকারী ঘটনাটি শুরু বা শনাক্ত করা হয়েছিল।

endTime

string ( Timestamp format)

ঐচ্ছিক। এই সতর্কতা সৃষ্টিকারী ঘটনাটি সক্রিয় হওয়া বন্ধ করার সময়। প্রদান করা হলে, শেষের সময়টি শুরুর সময়ের আগে হওয়া উচিত নয়। প্রদান করা না হলে, এটি একটি চলমান সতর্কতা নির্দেশ করে।

type

string

প্রয়োজন। সতর্কতার ধরন। সতর্কতা তৈরি হওয়ার পরেই এটি আউটপুট। উপলব্ধ অ্যালার্ট প্রকারের তালিকার জন্য Google Workspace Alert প্রকারগুলি দেখুন।

source

string

প্রয়োজন। সতর্কতা রিপোর্ট করা সিস্টেমের জন্য একটি অনন্য শনাক্তকারী। সতর্কতা তৈরি হওয়ার পরেই এটি আউটপুট।

সমর্থিত উত্সগুলি নিম্নলিখিতগুলির মধ্যে যেকোনো একটি:

  • গুগল অপারেশন
  • মোবাইল ডিভাইস ব্যবস্থাপনা
  • জিমেইল ফিশিং
  • তথ্য সংরক্ষণ
  • ডোমেন ওয়াইড টেকআউট
  • রাষ্ট্রীয় পৃষ্ঠপোষকতায় হামলা
  • Google পরিচয়
  • অ্যাপস বিভ্রাট
data

object

ঐচ্ছিক। এই সতর্কতার সাথে সম্পর্কিত ডেটা, উদাহরণস্বরূপ google.apps.alertcenter.type.DeviceCompromised

deleted

boolean

শুধুমাত্র আউটপুট। True যদি এই সতর্কতা মুছে ফেলার জন্য চিহ্নিত করা হয়।

metadata

object ( AlertMetadata )

শুধুমাত্র আউটপুট। এই সতর্কতার সাথে যুক্ত মেটাডেটা।

updateTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। এই সতর্কতা সর্বশেষ আপডেট করার সময়.

etag

string

ঐচ্ছিক। etag একটি সতর্কতার যুগপত আপডেট একে অপরকে ওভাররাইট করা থেকে আটকাতে সাহায্য করার একটি উপায় হিসাবে আশাবাদী সমসাময়িক নিয়ন্ত্রণের জন্য ব্যবহার করা হয়। এটা দৃঢ়ভাবে সুপারিশ করা হয় যে সিস্টেমগুলি জাতিগত পরিস্থিতি এড়াতে সতর্কতা আপডেটগুলি সম্পাদন করতে পঠন-সংশোধন-লেখা চক্রে etag ব্যবহার করে: প্রতিক্রিয়াতে একটি etag ফেরত দেওয়া হয় যাতে সতর্কতা থাকে, এবং সিস্টেমগুলি সেই etagটি স্থাপন করবে বলে আশা করা হচ্ছে তাদের পরিবর্তন সতর্কতার একই সংস্করণে প্রয়োগ করা হবে তা নিশ্চিত করতে সতর্কতা আপডেট করার অনুরোধ।

যদি সতর্কতা আপডেট করার জন্য কলে কোনো etag প্রদান করা না হয়, তাহলে বিদ্যমান সতর্কতা অন্ধভাবে ওভাররাইট করা হয়।

সতর্কতা মেটাডেটা

একটি সতর্কতা মেটাডেটা।

JSON প্রতিনিধিত্ব
{
  "customerId": string,
  "alertId": string,
  "status": string,
  "assignee": string,
  "updateTime": string,
  "severity": string,
  "etag": string
}
ক্ষেত্র
customerId

string

শুধুমাত্র আউটপুট। গ্রাহকের Google Workspace অ্যাকাউন্টের অনন্য শনাক্তকারী।

alertId

string

শুধুমাত্র আউটপুট। সতর্কতা শনাক্তকারী।

status

string

সতর্কতার বর্তমান অবস্থা। সমর্থিত মানগুলি নিম্নরূপ:

  • শুরু না
  • চলমান
  • বন্ধ
assignee

string

সতর্কতার জন্য নির্ধারিত ব্যবহারকারীর ইমেল ঠিকানা।

updateTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। এই মেটাডেটা শেষ আপডেট করার সময়।

severity

string

সতর্কতার তীব্রতার মান। সতর্কতা কেন্দ্র সতর্কতা তৈরির সময় এই ক্ষেত্রটি সেট করবে, যখন এটি নির্ধারণ করা যায় না তখন একটি খালি স্ট্রিংতে ডিফল্ট। এই ক্ষেত্রের আপডেট কর্মের জন্য সমর্থিত মান নিম্নরূপ:

  • উচ্চ
  • মধ্যম
  • কম
etag

string

ঐচ্ছিক। etag একটি সতর্কতা মেটাডেটা একে অপরকে ওভাররাইট করা থেকে একযোগে আপডেট হওয়া প্রতিরোধে সাহায্য করার উপায় হিসাবে আশাবাদী একযোগে নিয়ন্ত্রণের জন্য ব্যবহার করা হয়। এটা দৃঢ়ভাবে সুপারিশ করা হয় যে সিস্টেমগুলি মেটাডেটা আপডেটগুলি সম্পাদন করতে পঠন-সংশোধন-লেখা চক্রে etag ব্যবহার করে জাতিগত পরিস্থিতি এড়াতে: প্রতিক্রিয়াতে একটি etag ফেরত দেওয়া হয় যার মধ্যে সতর্কতা মেটাডেটা থাকে, এবং সিস্টেমগুলি সেই ইটাগ রাখবে বলে আশা করা হচ্ছে সতর্কতা মেটাডেটা আপডেট করার অনুরোধে নিশ্চিত করুন যে তাদের পরিবর্তন সতর্কতা মেটাডেটার একই সংস্করণে প্রয়োগ করা হবে।

যদি সতর্কতা মেটাডেটা আপডেট করার জন্য কলে কোনো etag প্রদান করা না হয়, তাহলে বিদ্যমান সতর্কতা মেটাডেটা অন্ধভাবে ওভাররাইট করা হয়।

পদ্ধতি

batchDelete

অ্যালার্টে ব্যাচ ডিলিট অপারেশন করে।

batchUndelete

সতর্কতাগুলিতে ব্যাচ আনডিলিট অপারেশন সম্পাদন করে।

delete

মুছে ফেলার জন্য নির্দিষ্ট সতর্কতা চিহ্নিত করে।

get

নির্দিষ্ট সতর্কতা পায়।

getMetadata

একটি সতর্কতার মেটাডেটা ফেরত দেয়।

list

সতর্কতা তালিকা.

undelete

পুনরুদ্ধার, বা "আনডিলিট", একটি সতর্কতা যা গত 30 দিনের মধ্যে মুছে ফেলার জন্য চিহ্নিত করা হয়েছিল৷