DpcMigrationClient

কোটলিন | জাভা

public interface DpcMigrationClient

---

dpc মাইগ্রেশন সংক্রান্ত অনুরোধ করার জন্য ক্লায়েন্ট।

সারসংক্ষেপ

পাবলিক পদ্ধতি
abstract @ NonNull ListenableFuture < DpcMigrationAttempt >	getMigrationAttempt ( @ NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) একটি মাইগ্রেশন প্রচেষ্টা পায়.
abstract DpcMigrationAttempt	getMigrationAttemptAwait ( @ NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) একটি মাইগ্রেশন প্রচেষ্টা পায়.
abstract @ NonNull ListenableFuture <@ NonNull List <@ NonNull DpcMigrationAttempt >>	listMigrationAttempts () সমস্ত স্থানান্তর প্রচেষ্টার একটি তালিকা প্রদান করে৷
abstract @ NonNull List <@ NonNull DpcMigrationAttempt >	listMigrationAttemptsAwait () সমস্ত স্থানান্তর প্রচেষ্টার একটি তালিকা প্রদান করে৷
abstract @ NonNull ListenableFuture <@ NonNull DpcMigrationAttempt >	migrateDeviceManagementToAndroidManagementApi ( @ NonNull ComponentName notificationServiceComponentName, @ NonNull ComponentName adminComponentName, @ NonNull DpcMigrationRequest migrationRequest ) অ্যান্ড্রয়েড ম্যানেজমেন্ট API দ্বারা পরিচালিত এই ডিভাইসটিকে স্থানান্তর করুন৷
abstract @ NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait ( @ NonNull ComponentName notificationServiceComponentName, @ NonNull ComponentName adminComponentName, @ NonNull DpcMigrationRequest migrationRequest ) অ্যান্ড্রয়েড ম্যানেজমেন্ট API দ্বারা পরিচালিত এই ডিভাইসটিকে স্থানান্তর করুন৷

পাবলিক পদ্ধতি

getMigrationAttempt

abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

একটি মাইগ্রেশন প্রচেষ্টা পায়.

GetDpcMigrationAttemptRequest এ কোনো নাম উল্লেখ না থাকলে, সাম্প্রতিকতম DpcMigrationAttempt ফেরত দেওয়া হয়।

এই পদ্ধতিটি শুধুমাত্র একজন ডিভাইস মালিক বা প্রোফাইল মালিক, অথবা পূর্ববর্তী ডিভাইসের মালিক বা প্রোফাইল মালিক যেটি Android Management API-এ স্থানান্তরিত হয়েছে তাকে কল করা যেতে পারে।

রিটার্নস

@ NonNull ListenableFuture < DpcMigrationAttempt >

একটি ListenableFuture ফলাফল মোড়ানো. এটা হতে পারে সফলতার ক্ষেত্রে একটি DpcMigrationAttempt মোড়ানো একটি সফল ভবিষ্যৎ। DpcMigrationAttempt পাওয়া না গেলে একটি সফল ভবিষ্যত র্যাপিং নাল। একটি ব্যর্থ ভবিষ্যৎ একটি SecurityException মোড়ানো, যদি কলার একজন ডিভাইসের মালিক বা প্রোফাইলের মালিক না হয়, অথবা পূর্ববর্তী ডিভাইসের মালিক বা প্রোফাইলের মালিক না হয় যা Android Management API-এ স্থানান্তরিত হয়। একটি ব্যর্থ ভবিষ্যত মোড়ানো DpcMigrationException যদি dpc মাইগ্রেশন সম্পর্কিত কল ব্যর্থ হয়। বার্তা এবং ব্যতিক্রমের উপপ্রকার ব্যর্থতা সম্পর্কে আরও বিশদ ধারণ করে।

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

একটি মাইগ্রেশন প্রচেষ্টা পায়.

GetDpcMigrationAttemptRequest এ কোনো নাম উল্লেখ না থাকলে, সাম্প্রতিকতম DpcMigrationAttempt ফেরত দেওয়া হয়।

এই পদ্ধতিটি শুধুমাত্র একজন ডিভাইস মালিক বা প্রোফাইল মালিক, অথবা পূর্ববর্তী ডিভাইসের মালিক বা প্রোফাইল মালিক যেটি Android Management API-এ স্থানান্তরিত হয়েছে তাকে কল করা যেতে পারে।

রিটার্নস
DpcMigrationAttempt	অনুরোধ করা DpcMigrationAttempt বা নাল, যদি এটি পাওয়া না যায়

নিক্ষেপ করে
java.lang.SecurityException	কলকারী যদি কোনো ডিভাইসের মালিক বা প্রোফাইলের মালিক না হন, অথবা পূর্ববর্তী কোনো ডিভাইসের মালিক বা প্রোফাইলের মালিক না হন যা Android Management API-এ স্থানান্তরিত হয়েছে।
com.google.android.managementapi.dpcmigration.DpcMigrationException	যদি dpc মাইগ্রেশন সংক্রান্ত কল ব্যর্থ হয়। বার্তা এবং ব্যতিক্রমের উপপ্রকার ব্যর্থতা সম্পর্কে আরও বিশদ ধারণ করে।

তালিকা মাইগ্রেশন প্রচেষ্টা

abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()

সমস্ত স্থানান্তর প্রচেষ্টার একটি তালিকা প্রদান করে৷

এই পদ্ধতিটি শুধুমাত্র একজন ডিভাইস মালিক বা প্রোফাইল মালিক, অথবা পূর্ববর্তী ডিভাইসের মালিক বা প্রোফাইল মালিক যেটি Android Management API-এ স্থানান্তরিত হয়েছে তাকে কল করা যেতে পারে। দ্রষ্টব্য: পুরানো মাইগ্রেশন প্রচেষ্টা স্বয়ংক্রিয়ভাবে মুছে ফেলা হয় এবং ফেরত দেওয়া হয় না।

রিটার্নস

@ NonNull ListenableFuture <@ NonNull List <@ NonNull DpcMigrationAttempt >>

একটি ListenableFuture ফলাফল মোড়ানো. এটা হতে পারে সফলতার ক্ষেত্রে DpcMigrationAttempt এর একটি তালিকা মোড়ানো একটি সফল ভবিষ্যৎ। একটি ব্যর্থ ভবিষ্যৎ একটি SecurityException মোড়ানো, যদি কলার একজন ডিভাইসের মালিক বা প্রোফাইলের মালিক না হয়, অথবা পূর্ববর্তী ডিভাইসের মালিক বা প্রোফাইলের মালিক না হয় যা Android Management API-এ স্থানান্তরিত হয়। একটি ব্যর্থ ভবিষ্যত মোড়ানো DpcMigrationException যদি dpc মাইগ্রেশন সম্পর্কিত কল ব্যর্থ হয়। বার্তা এবং ব্যতিক্রমের উপপ্রকার ব্যর্থতা সম্পর্কে আরও বিশদ ধারণ করে।

ListMigrationAttemptsAwait

abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()

সমস্ত স্থানান্তর প্রচেষ্টার একটি তালিকা প্রদান করে৷

এই পদ্ধতিটি শুধুমাত্র একজন ডিভাইস মালিক বা প্রোফাইল মালিক, অথবা পূর্ববর্তী ডিভাইসের মালিক বা প্রোফাইল মালিক যেটি Android Management API-এ স্থানান্তরিত হয়েছে তাকে কল করা যেতে পারে। দ্রষ্টব্য: পুরানো মাইগ্রেশন প্রচেষ্টা স্বয়ংক্রিয়ভাবে মুছে ফেলা হয় এবং ফেরত দেওয়া হয় না।

রিটার্নস
@ NonNull List <@ NonNull DpcMigrationAttempt >	DpcMigrationAttempt এর একটি তালিকা

নিক্ষেপ করে
java.lang.SecurityException	কলকারী যদি কোনো ডিভাইসের মালিক বা প্রোফাইলের মালিক না হন, অথবা পূর্ববর্তী কোনো ডিভাইসের মালিক বা প্রোফাইলের মালিক না হন যা Android Management API-এ স্থানান্তরিত হয়েছে।
com.google.android.managementapi.dpcmigration.DpcMigrationException	যদি dpc মাইগ্রেশন সংক্রান্ত কল ব্যর্থ হয়। বার্তা এবং ব্যতিক্রমের উপপ্রকার ব্যর্থতা সম্পর্কে আরও বিশদ ধারণ করে।

MigrateDeviceManagementToAndroidManagementApi

abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

অ্যান্ড্রয়েড ম্যানেজমেন্ট API দ্বারা পরিচালিত এই ডিভাইসটিকে স্থানান্তর করুন৷

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

সতর্কতা: এটি পূর্বাবস্থায় ফেরানো যাবে না! ফিরে আসা ListenableFuture সম্পূর্ণ হয় যখন Android Device Policy অনুরোধটি গ্রহণ করে এবং মাইগ্রেশন টোকেনে প্রাথমিক চেক সম্পন্ন করে। ব্যর্থতার ক্ষেত্রে লিসেনেবল ফিউচার একটি Exception মোড়ানো হবে।

এই পদ্ধতিটি শুধুমাত্র একজন ডিভাইস মালিক বা প্রোফাইল মালিক দ্বারা কল করা যেতে পারে। Android 10 এবং তার নিচের সংস্করণে, ডিভাইসের মালিক এবং প্রোফাইল মালিক উভয়েরই ডিভাইসে এটি কল করা উচিত নয়।

কনফিগার করা Wi-Fi নেটওয়ার্কগুলিকে DpcMigrationRequest এ প্রোফাইল মালিকের (Android 12 ছাড়া) ব্যক্তিগত মালিকানাধীন ডিভাইসে পাস করতে হবে যদি এটি কোনো Wi-Fi নেটওয়ার্ক কনফিগার করে থাকে। এগুলি অবশ্যই কোম্পানির মালিকানাধীন ডিভাইসে পাস করা উচিত নয়। মনে রাখবেন যে ডিভাইস পরিচালনা Android ডিভাইস নীতিতে স্থানান্তরিত হওয়ার ঠিক আগে এই Wi-Fi নেটওয়ার্কগুলি সরানো হবে৷ একটি নেটওয়ার্ক সরাতে ব্যর্থতার ক্ষেত্রে, মাইগ্রেশনও ব্যর্থ হবে এবং যেহেতু নেটওয়ার্কগুলি অপসারণ করা একটি পারমাণবিক অপারেশন নয়, তাই কিছু নেটওয়ার্ক ইতিমধ্যেই মুছে ফেলা হতে পারে।

Android 12 চালিত কাজের প্রোফাইল সহ ব্যক্তিগত মালিকানাধীন ডিভাইসগুলিতে, migrationRequest পাস করা Wi-Fi নেটওয়ার্কগুলি নির্বিশেষে ডিভাইস পরিচালনা Android ডিভাইস নীতিতে স্থানান্তরিত হওয়ার ঠিক আগে কলিং DPC দ্বারা কনফিগার করা সমস্ত Wi-Fi নেটওয়ার্ক সরানো হবে।

পরামিতি
@ NonNull ComponentName notificationServiceComponentName	NotificationReceiverService প্রসারিত পরিষেবার ComponentName ৷ এটি অবশ্যই কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান হতে হবে এবং ম্যানিফেস্টে রপ্তানি করা হবে, অন্যথায় একটি IllegalArgumentException নিক্ষেপ করা হবে৷
@ NonNull ComponentName adminComponentName	কলিং DPC-এর অ্যাডমিন DeviceAdminReceiver ComponentName ৷
@ NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest যেখানে মাইগ্রেশন টোকেন এবং কনফিগার করা Wi-Fi নেটওয়ার্ক রয়েছে৷ পরবর্তীটি শুধুমাত্র তখনই প্রয়োজন হয় যখন কলকারী ব্যক্তিগত মালিকানাধীন ডিভাইসে প্রোফাইলের মালিক হন এবং কোনো নেটওয়ার্ক কনফিগার করে থাকেন।

রিটার্নস

@ NonNull ListenableFuture <@ NonNull DpcMigrationAttempt >

একটি ListenableFuture ফলাফল মোড়ানো. এটা হতে পারে সফলতার ক্ষেত্রে একটি DpcMigrationAttempt মোড়ানো একটি সফল ভবিষ্যৎ। একটি ব্যর্থ ভবিষ্যৎ একটি SecurityException মোড়ানো, যদি কলকারী একজন ডিভাইসের মালিক বা প্রোফাইলের মালিক না হয়। একটি IllegalArgumentException মোড়ানো একটি ব্যর্থ ভবিষ্যত, যদি মাইগ্রেশন টোকেন খালি থাকে, অথবা যদি notificationServiceComponentName ম্যানিফেস্টে রপ্তানি করা NotificationReceiverService প্রসারিত একটি বৈধ উপাদান উল্লেখ না করে, অথবা যদি adminComponentName বর্তমান প্যাকেজের অন্তর্গত একটি সক্রিয় প্রশাসক না হয়। একটি ব্যর্থ ভবিষ্যৎ একটি DpcMigrationException মোড়ানো, যদি dpc মাইগ্রেশন সম্পর্কিত কল ব্যর্থ হয়। বার্তা এবং ব্যতিক্রমের উপপ্রকার ব্যর্থতা সম্পর্কে আরও বিশদ ধারণ করে।

MigrateDeviceManagementToAndroidManagementApiAwait

abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

অ্যান্ড্রয়েড ম্যানেজমেন্ট API দ্বারা পরিচালিত এই ডিভাইসটিকে স্থানান্তর করুন৷

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

সতর্কতা: এটি পূর্বাবস্থায় ফেরানো যাবে না! যখন Android ডিভাইস নীতি অনুরোধটি গ্রহণ করে এবং মাইগ্রেশন টোকেনে প্রাথমিক চেক সম্পন্ন করে তখন এই স্থগিত মজা ফিরে আসে। ব্যর্থতার ক্ষেত্রে একটি Exception নিক্ষেপ করা হয়।

এই পদ্ধতিটি শুধুমাত্র একজন ডিভাইস মালিক বা প্রোফাইল মালিক দ্বারা কল করা যেতে পারে। Android 10 এবং তার নিচের সংস্করণে, ডিভাইসের মালিক এবং প্রোফাইল মালিক উভয়েরই ডিভাইসে এটি কল করা উচিত নয়।

কনফিগার করা Wi-Fi নেটওয়ার্কগুলিকে DpcMigrationRequest এ প্রোফাইল মালিকের (Android 12 ছাড়া) ব্যক্তিগত মালিকানাধীন ডিভাইসে পাস করতে হবে যদি এটি কোনো Wi-Fi নেটওয়ার্ক কনফিগার করে থাকে। এগুলি অবশ্যই কোম্পানির মালিকানাধীন ডিভাইসে পাস করা উচিত নয়। মনে রাখবেন যে ডিভাইস পরিচালনা Android ডিভাইস নীতিতে স্থানান্তরিত হওয়ার ঠিক আগে এই Wi-Fi নেটওয়ার্কগুলি সরানো হবে৷ একটি নেটওয়ার্ক সরাতে ব্যর্থতার ক্ষেত্রে, মাইগ্রেশনও ব্যর্থ হবে এবং যেহেতু নেটওয়ার্কগুলি অপসারণ করা একটি পারমাণবিক অপারেশন নয়, তাই কিছু নেটওয়ার্ক ইতিমধ্যেই মুছে ফেলা হতে পারে।

Android 12 চালিত কাজের প্রোফাইল সহ ব্যক্তিগত মালিকানাধীন ডিভাইসগুলিতে, migrationRequest পাস করা Wi-Fi নেটওয়ার্কগুলি নির্বিশেষে ডিভাইস পরিচালনা Android ডিভাইস নীতিতে স্থানান্তরিত হওয়ার ঠিক আগে কলিং DPC দ্বারা কনফিগার করা সমস্ত Wi-Fi নেটওয়ার্ক সরানো হবে।

পরামিতি
@ NonNull ComponentName notificationServiceComponentName	NotificationReceiverService প্রসারিত পরিষেবার ComponentName ৷ এটি অবশ্যই কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান হতে হবে এবং ম্যানিফেস্টে রপ্তানি করা হবে, অন্যথায় একটি IllegalArgumentException নিক্ষেপ করা হবে৷
@ NonNull ComponentName adminComponentName	কলিং DPC-এর অ্যাডমিন DeviceAdminReceiver ComponentName ৷
@ NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest যেখানে মাইগ্রেশন টোকেন এবং কনফিগার করা Wi-Fi নেটওয়ার্ক রয়েছে৷ পরবর্তীটি শুধুমাত্র তখনই প্রয়োজন হয় যখন কলকারী ব্যক্তিগত মালিকানাধীন ডিভাইসে প্রোফাইলের মালিক হন এবং কোনো নেটওয়ার্ক কনফিগার করে থাকেন।

রিটার্নস
@ NonNull DpcMigrationAttempt	সফলতার ক্ষেত্রে মাইগ্রেশনের বর্তমান অবস্থার সাথে DpcMigrationException ।

নিক্ষেপ করে
java.lang.SecurityException	কলকারী যদি ডিভাইসের মালিক বা প্রোফাইলের মালিক না হন।
java.lang.IllegalArgumentException	যদি মাইগ্রেশন টোকেন খালি থাকে, অথবা যদি notificationServiceComponentName ম্যানিফেস্টে রপ্তানি করা NotificationReceiverService প্রসারিত একটি বৈধ উপাদান উল্লেখ না করে, অথবা যদি adminComponentName বর্তমান প্যাকেজের অন্তর্গত একজন সক্রিয় প্রশাসক না হয়।
com.google.android.managementapi.dpcmigration.DpcMigrationException	যদি dpc মাইগ্রেশন সংক্রান্ত কল ব্যর্থ হয়। বার্তা এবং ব্যতিক্রমের উপপ্রকার ব্যর্থতা সম্পর্কে আরও বিশদ ধারণ করে।