Query Active Directory authentication settings by calling GetInstanceADAuthServer-Bastionhost-Alibaba Cloud - Bastionhost

Mengkueri konfigurasi otentikasi Direktori Aktif (AD) instans Host Bastion.

Deskripsi operasi

Catatan penggunaan

Operasi ini mengkueri konfigurasi otentikasi Direktori Aktif (AD) instans Host Bastion. Anda dapat menggunakan fitur otentikasi AD Host Bastion untuk menyinkronkan pengguna dari server AD ke Host Bastion. Setelah penyinkronan selesai, pengguna dapat melakukan operasi O&M pada server dengan menggunakan Host Bastion. Untuk operasi terkelola tingkat perusahaan, Anda juga dapat melihat Alibaba Cloud Managed Services.

Batas QPS

Batas queries per second (QPS) untuk operasi ini adalah 10 per pengguna. Jika jumlah pemanggilan API melebihi batas, pembatasan kecepatan akan dipicu, yang dapat memengaruhi bisnis Anda. Panggil operasi ini pada frekuensi yang wajar.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

yundun-bastionhost:GetInstanceADAuthServer

get

*Instans.

acs:yundun-bastionhost:{#regionId}:{#accountId}:instance/{#InstanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans Host Bastion. Catatan Anda dapat memanggil operasi DescribeInstances untuk mengkueri ID instans.	bastionhost-cn-st220aw****
RegionId	string	No	ID wilayah instans Host Bastion. Catatan Untuk informasi selengkapnya tentang pemetaan antara ID wilayah dan nama wilayah, lihat Wilayah dan zona.	cn-hangzhou
UserSourceId	string	No

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan. ID ini adalah pengidentifikasi unik yang dibuat oleh Alibaba Cloud untuk permintaan dan dapat digunakan untuk memecahkan masalah.	89398CFB-4EB6-4C7E-BB3C-EF213AC8FA50
AD	object	Konfigurasi otentikasi Direktori Aktif (AD).
Account	string	Distinguished name (DN) akun server.	cn=Manager,dc=test,dc=com
BaseDN	string	Base DN yang digunakan untuk terhubung ke server AD.	dc=test,dc=com
Domain	string	Domain pada server AD.	domain
EmailMapping	string	Nama bidang yang dipetakan ke alamat email pengguna pada server AD.	emailAttr
Filter	string	Kondisi filter untuk pengguna.	(&(objectClass=top))
IsSSL	boolean	Apakah SSL didukung. Nilai valid: true: Didukung. false: Tidak didukung.	true
MobileMapping	string	Nama bidang yang dipetakan ke nomor ponsel pengguna pada server AD.	mobileAttr
NameMapping	string	Nama bidang yang dipetakan ke nama pengguna pada server AD.	nameAttr
HasPassword	boolean	Apakah kata sandi telah ditetapkan. Nilai valid: true: Kata sandi telah ditetapkan. false: Kata sandi belum ditetapkan.	true
Port	integer	Port server.	389
Server	string	Alamat server.	192.168.XX.XX
StandbyServer	string	Alamat server cadangan.	192.168.XX.XX
LatestSyncTime	integer	Pengatur waktu saat Snapshot pengguna terakhir disinkronkan.	0
SyncInterval	integer	Interval untuk sinkronisasi otomatis snapshot pengguna. Unit: hours. Nilai valid: 0, dan 4 hingga 168. Nilai 0 menunjukkan bahwa sinkronisasi otomatis dinonaktifkan dan tidak ada penyinkronan yang dilakukan.	0
IsSyncEmailAttr	boolean	Apakah alamat email disinkronkan. Nilai true menunjukkan bahwa alamat email disinkronkan, dan nilai false menunjukkan bahwa alamat email tidak disinkronkan.	true
IsSyncMobileAttr	boolean	Apakah nomor ponsel disinkronkan. Nilai true menunjukkan bahwa nomor ponsel disinkronkan, dan nilai false menunjukkan bahwa nomor ponsel tidak disinkronkan.	true
IsSyncNameAttr	boolean	Apakah nama tampilan disinkronkan. Nilai true menunjukkan bahwa nama tampilan disinkronkan, dan nilai false menunjukkan bahwa nama tampilan tidak disinkronkan.	true
ServerName	string	Nama server otentikasi AD.	AD Server
IsSyncOuAsUserGroup	boolean	Apakah organisasi tempat pengguna berada disinkronkan sebagai kelompok pengguna. Nilai true menunjukkan bahwa organisasi disinkronkan sebagai kelompok pengguna, dan nilai false menunjukkan bahwa organisasi tidak disinkronkan sebagai kelompok pengguna.	true
UserSourceId	string
IsDefault	boolean	Apakah server adalah server otentikasi AD default. Nilai true menunjukkan bahwa server adalah server otentikasi AD default, dan nilai false menunjukkan bahwa server bukan server otentikasi AD default.	true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "89398CFB-4EB6-4C7E-BB3C-EF213AC8FA50",
  "AD": {
    "Account": "cn=Manager,dc=test,dc=com",
    "BaseDN": "dc=test,dc=com",
    "Domain": "domain",
    "EmailMapping": "emailAttr",
    "Filter": "(&(objectClass=top))",
    "IsSSL": true,
    "MobileMapping": "mobileAttr",
    "NameMapping": "nameAttr",
    "HasPassword": true,
    "Port": 389,
    "Server": "192.168.XX.XX",
    "StandbyServer": "192.168.XX.XX",
    "LatestSyncTime": 0,
    "SyncInterval": 0,
    "IsSyncEmailAttr": true,
    "IsSyncMobileAttr": true,
    "IsSyncNameAttr": true,
    "ServerName": "AD Server",
    "IsSyncOuAsUserGroup": true,
    "UserSourceId": "",
    "IsDefault": true
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParameter	The argument is invalid.
500	InternalError	An unknown error occurred.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.