Code

gRPC API-এর জন্য ক্যানোনিকাল ত্রুটি কোড।

কখনও কখনও একাধিক ত্রুটি কোড প্রযোজ্য হতে পারে। পরিষেবাগুলি প্রযোজ্য সবচেয়ে নির্দিষ্ট ত্রুটি কোডটি ফেরত দেবে। উদাহরণস্বরূপ, যদি উভয় কোড প্রযোজ্য হয় তবে FAILED_PRECONDITION এর চেয়ে OUT_OF_RANGE পছন্দ করুন। একইভাবে FAILED_PRECONDITION এর চেয়ে NOT_FOUND বা ALREADY_EXISTS পছন্দ করুন।

এনামস
OK

কোনও ভুল নয়; সাফল্যের সাথে ফিরে এসেছি।

HTTP ম্যাপিং: ২০০ ঠিক আছে

CANCELLED

অপারেশনটি বাতিল করা হয়েছিল, সাধারণত কলকারীর দ্বারা।

HTTP ম্যাপিং: 499 ক্লায়েন্ট ক্লোজড রিকোয়েস্ট

UNKNOWN

অজানা ত্রুটি। উদাহরণস্বরূপ, এই ত্রুটিটি তখনই ফিরে আসতে পারে যখন অন্য ঠিকানা স্থান থেকে প্রাপ্ত একটি Status মান এমন একটি ত্রুটি স্থানের অন্তর্গত যা এই ঠিকানা স্থানের অজানা। এছাড়াও, API দ্বারা উত্থাপিত ত্রুটিগুলি যা পর্যাপ্ত ত্রুটি তথ্য প্রদান করে না সেগুলি এই ত্রুটিতে রূপান্তরিত হতে পারে।

HTTP ম্যাপিং: ৫০০ অভ্যন্তরীণ সার্ভার ত্রুটি

INVALID_ARGUMENT

ক্লায়েন্ট একটি অবৈধ আর্গুমেন্ট নির্দিষ্ট করেছে। মনে রাখবেন এটি FAILED_PRECONDITION থেকে আলাদা। INVALID_ARGUMENT এমন আর্গুমেন্ট নির্দেশ করে যা সিস্টেমের অবস্থা নির্বিশেষে সমস্যাযুক্ত (যেমন, একটি ত্রুটিপূর্ণ ফাইলের নাম)।

HTTP ম্যাপিং: 400 খারাপ অনুরোধ

DEADLINE_EXCEEDED

অপারেশনটি সম্পূর্ণ হওয়ার আগেই সময়সীমা শেষ হয়ে গেছে। সিস্টেমের অবস্থা পরিবর্তনকারী অপারেশনগুলির জন্য, অপারেশনটি সফলভাবে সম্পন্ন হলেও এই ত্রুটিটি ফিরে আসতে পারে। উদাহরণস্বরূপ, একটি সার্ভার থেকে একটি সফল প্রতিক্রিয়া সময়সীমা শেষ হওয়ার জন্য যথেষ্ট বিলম্বিত হতে পারে।

HTTP ম্যাপিং: ৫০৪ গেটওয়ে টাইমআউট

NOT_FOUND

কিছু অনুরোধকৃত সত্তা (যেমন, ফাইল বা ডিরেক্টরি) পাওয়া যায়নি।

সার্ভার ডেভেলপারদের জন্য নোট: যদি ব্যবহারকারীদের একটি সম্পূর্ণ শ্রেণীর জন্য কোনও অনুরোধ প্রত্যাখ্যান করা হয়, যেমন ধীরে ধীরে বৈশিষ্ট্য রোলআউট বা নথিভুক্ত নয় এমন অ্যালোলিস্ট, তাহলে NOT_FOUND ব্যবহার করা যেতে পারে। যদি ব্যবহারকারীদের একটি শ্রেণীর মধ্যে কিছু ব্যবহারকারীর জন্য কোনও অনুরোধ প্রত্যাখ্যান করা হয়, যেমন ব্যবহারকারী-ভিত্তিক অ্যাক্সেস নিয়ন্ত্রণ, তাহলে PERMISSION_DENIED ব্যবহার করতে হবে।

HTTP ম্যাপিং: 404 পাওয়া যায়নি

ALREADY_EXISTS

ক্লায়েন্ট যে সত্তাটি তৈরি করার চেষ্টা করেছিল (যেমন, ফাইল বা ডিরেক্টরি) তা ইতিমধ্যেই বিদ্যমান।

HTTP ম্যাপিং: 409 দ্বন্দ্ব

PERMISSION_DENIED

কলকারীর নির্দিষ্ট ক্রিয়াকলাপটি সম্পাদন করার অনুমতি নেই। কিছু রিসোর্স ক্লান্ত করার কারণে প্রত্যাখ্যানের ক্ষেত্রে PERMISSION_DENIED ব্যবহার করা উচিত নয় (এই ত্রুটিগুলির জন্য RESOURCE_EXHAUSTED ব্যবহার করুন)। যদি কলকারীকে সনাক্ত করা না যায় তবে PERMISSION_DENIED ব্যবহার করা উচিত নয় (এই ত্রুটিগুলির জন্য UNAUTHENTICATED ব্যবহার করুন)। এই ত্রুটি কোডটি বোঝায় না যে অনুরোধটি বৈধ বা অনুরোধকৃত সত্তা বিদ্যমান বা অন্যান্য পূর্ব-শর্ত পূরণ করে।

HTTP ম্যাপিং: 403 নিষিদ্ধ

UNAUTHENTICATED

অনুরোধটিতে ক্রিয়াকলাপের জন্য বৈধ প্রমাণীকরণ শংসাপত্র নেই।

HTTP ম্যাপিং: 401 অননুমোদিত

RESOURCE_EXHAUSTED

কিছু রিসোর্স শেষ হয়ে গেছে, সম্ভবত প্রতি ব্যবহারকারীর কোটা, অথবা সম্ভবত পুরো ফাইল সিস্টেমে জায়গা নেই।

HTTP ম্যাপিং: ৪২৯টি অনেক বেশি অনুরোধ

FAILED_PRECONDITION

অপারেশনটি বাতিল করা হয়েছে কারণ সিস্টেমটি অপারেশনটি সম্পাদনের জন্য প্রয়োজনীয় অবস্থায় নেই। উদাহরণস্বরূপ, যে ডিরেক্টরিটি মুছে ফেলা হবে তা খালি নয়, একটি rmdir অপারেশন একটি নন-ডিরেক্টরিতে প্রয়োগ করা হয়েছে, ইত্যাদি।

পরিষেবা বাস্তবায়নকারীরা নিম্নলিখিত নির্দেশিকাগুলি ব্যবহার করে FAILED_PRECONDITION , ABORTED এবং UNAVAILABLE মধ্যে সিদ্ধান্ত নিতে পারেন: (a) যদি ক্লায়েন্ট কেবল ব্যর্থ কলটি পুনরায় চেষ্টা করতে পারে তবে UNAVAILABLE ব্যবহার করুন। (b) যদি ক্লায়েন্ট উচ্চতর স্তরে পুনরায় চেষ্টা করতে চায় তবে ABORTED ব্যবহার করুন। উদাহরণস্বরূপ, যখন একটি ক্লায়েন্ট-নির্দিষ্ট পরীক্ষা-এবং-সেট ব্যর্থ হয়, ক্লায়েন্টকে একটি পঠন-পরিবর্তন-লেখার ক্রম পুনরায় চালু করতে হবে তা নির্দেশ করে। (c) যদি সিস্টেমের অবস্থা স্পষ্টভাবে ঠিক না করা পর্যন্ত ক্লায়েন্ট পুনরায় চেষ্টা না করে তবে FAILED_PRECONDITION ব্যবহার করুন। উদাহরণস্বরূপ, যদি একটি "rmdir" ব্যর্থ হয় কারণ ডিরেক্টরিটি খালি নেই, তাহলে FAILED_PRECONDITION ফেরত দেওয়া উচিত কারণ ডিরেক্টরি থেকে ফাইলগুলি মুছে ফেলা না হলে ক্লায়েন্ট পুনরায় চেষ্টা করা উচিত নয়।

HTTP ম্যাপিং: 400 খারাপ অনুরোধ

ABORTED

অপারেশনটি বাতিল করা হয়েছিল, সাধারণত সিকোয়েন্সার চেক ব্যর্থতা বা লেনদেন বাতিলের মতো একটি কনকারেন্সি সমস্যার কারণে।

FAILED_PRECONDITION , ABORTED এবং UNAVAILABLE এর মধ্যে সিদ্ধান্ত নেওয়ার জন্য উপরের নির্দেশিকাগুলি দেখুন।

HTTP ম্যাপিং: 409 দ্বন্দ্ব

OUT_OF_RANGE

বৈধ পরিসর অতিক্রম করে অপারেশনটি করার চেষ্টা করা হয়েছিল। যেমন, ফাইলের শেষের দিকে খোঁজা বা পড়া।

INVALID_ARGUMENT বিপরীতে, এই ত্রুটিটি এমন একটি সমস্যা নির্দেশ করে যা সিস্টেমের অবস্থা পরিবর্তন হলে ঠিক করা যেতে পারে। উদাহরণস্বরূপ, একটি 32-বিট ফাইল সিস্টেম INVALID_ARGUMENT তৈরি করবে যদি [0,2^32-1] রেঞ্জের মধ্যে না থাকা অফসেটে পড়তে বলা হয়, তবে এটি বর্তমান ফাইলের আকারের বাইরের অফসেট থেকে পড়তে বলা হলে OUT_OF_RANGE তৈরি করবে।

FAILED_PRECONDITION এবং OUT_OF_RANGE মধ্যে বেশ কিছুটা ওভারল্যাপ রয়েছে। আমরা OUT_OF_RANGE (আরও নির্দিষ্ট ত্রুটি) ব্যবহার করার পরামর্শ দিচ্ছি যাতে কোনও স্পেসের মধ্য দিয়ে পুনরাবৃত্তি করা কলাররা সহজেই OUT_OF_RANGE ত্রুটিটি খুঁজে বের করতে পারে এবং কখন এটি সম্পন্ন হয়েছে তা সনাক্ত করতে পারে।

HTTP ম্যাপিং: 400 খারাপ অনুরোধ

UNIMPLEMENTED

এই পরিষেবাটিতে অপারেশনটি বাস্তবায়িত হয়নি অথবা সমর্থিত/সক্রিয় নয়।

HTTP ম্যাপিং: 501 বাস্তবায়িত হয়নি

INTERNAL

অভ্যন্তরীণ ত্রুটি। এর অর্থ হল অন্তর্নিহিত সিস্টেম দ্বারা প্রত্যাশিত কিছু ইনভেরিয়েন্ট ভেঙে গেছে। এই ত্রুটি কোডটি গুরুতর ত্রুটির জন্য সংরক্ষিত।

HTTP ম্যাপিং: ৫০০ অভ্যন্তরীণ সার্ভার ত্রুটি

UNAVAILABLE

পরিষেবাটি বর্তমানে অনুপলব্ধ। এটি সম্ভবত একটি ক্ষণস্থায়ী অবস্থা, যা ব্যাকঅফ দিয়ে পুনরায় চেষ্টা করে সংশোধন করা যেতে পারে। মনে রাখবেন যে অ-ইডেম্পটেন্ট অপারেশনগুলি পুনরায় চেষ্টা করা সবসময় নিরাপদ নয়।

FAILED_PRECONDITION , ABORTED এবং UNAVAILABLE এর মধ্যে সিদ্ধান্ত নেওয়ার জন্য উপরের নির্দেশিকাগুলি দেখুন।

HTTP ম্যাপিং: 503 পরিষেবা অনুপলব্ধ

DATA_LOSS

অপ্রত্যাশিত তথ্য ক্ষতি বা দুর্নীতি।

HTTP ম্যাপিং: ৫০০ অভ্যন্তরীণ সার্ভার ত্রুটি