Gunakan GetPolicy untuk mengkueri detail kebijakan kontrol - Bastionhost - Alibaba Cloud - Bastionhost

Mengambil detail kebijakan kontrol tertentu.

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:GetPolicy

get

*Semua sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans bastion host tempat kebijakan kontrol berada. Catatan Anda dapat memanggil operasi DescribeInstances untuk mendapatkan parameter ini.	bastionhost-cn-zvp2d3syb0g
RegionId	string	No	ID wilayah instans bastion host tempat kebijakan kontrol berada. Catatan Untuk pemetaan antara ID wilayah dan nama wilayah, lihat Regions and zones.	cn-hangzhou
PolicyId	string	Yes	ID kebijakan kontrol yang akan dikueri. Catatan Anda dapat memanggil operasi ListPolicies untuk mendapatkan parameter ini.	3
ProjectId	integer	No	ID proyek.	3

Elemen respons

Element	Type	Description	Example
	object
Policy	object	Detail kebijakan kontrol.
AccessTimeRangeConfig	object	Detail pembatasan rentang pengatur waktu logon.
EffectiveTime	array<object>	Detail rentang pengatur waktu logon yang diizinkan.
	object
Days	array	Hari logon yang diizinkan.
	string	Hari dalam seminggu saat logon diizinkan. Nilai valid: 1: Senin 2: Selasa 3: Rabu 4: Kamis 5: Jumat 6: Sabtu 7: Minggu	[2]
Hours	array	Jam logon yang diizinkan.
	string	Jam dalam sehari saat logon diizinkan. Nilai valid: 0: 0:00 hingga 1:00. 1: 1:00 hingga 2:00. 2: 2:00 hingga 3:00. 3: 3:00 hingga 4:00. 4: 4:00 hingga 5:00. 5: 5:00 hingga 6:00. 6: 6:00 hingga 7:00. 7: 7:00 hingga 8:00. 8: 8:00 hingga 9:00. 9: 9:00 hingga 10:00. 10: 10:00 hingga 11:00. 11: 11:00 hingga 12:00. 12: 12:00 hingga 13:00. 13: 13:00 hingga 14:00. 14: 14:00 hingga 15:00. 15: 15:00 hingga 16:00. 16: 16:00 hingga 17:00. 17: 17:00 hingga 18:00. 18: 18:00 hingga 19:00. 19: 19:00 hingga 20:00. 20: 20:00 hingga 21:00. 21: 21:00 hingga 22:00. 22: 22:00 hingga 23:00. 23: 23:00 hingga 0:00.	[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]
CommandConfig	object	Detail kebijakan perintah.
Approval	object	Detail konfigurasi persetujuan perintah.
Commands	array	Array perintah.
	string	Detail perintah yang memerlukan persetujuan.	ls
Deny	object	Detail konfigurasi kontrol perintah.
AclType	string	Tipe kontrol perintah. Nilai valid: white: mode daftar putih. black: mode daftar hitam.	black
Commands	array	Array perintah.
	string	Detail perintah.	ls
Comment	string	Deskripsi kebijakan kontrol.	comment
IPAclConfig	object	Detail konfigurasi pembatasan IP sumber.
AclType	string	Mode pembatasan IP sumber. Nilai valid: white: mode daftar putih. black: mode daftar hitam.	black
IPs	array	Informasi alamat IP untuk pembatasan logon.
	string	Daftar alamat IP yang dibatasi.	[10.10..]
PolicyName	string	Nama Kebijakan kebijakan kontrol.	test
PolicyId	string	ID kebijakan kontrol.	3
Priority	integer	Prioritas kebijakan kontrol. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.	1
ProtocolConfig	object	Detail kontrol protokol.
RDP	object	Detail konfigurasi opsi RDP.
ClipboardDownload	string	Konfigurasi unduhan clipboard. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
ClipboardUpload	string	Konfigurasi unggahan clipboard. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
DiskRedirection	string	Konfigurasi pemetaan drive/printer. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
RecordKeyboard	string	Konfigurasi perekaman keyboard. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
DiskRedirectionUpload	string	Kontrol unggahan disk RDP.	Enable
DiskRedirectionDownload	string	Kontrol unduhan disk RDP.	Enable
SSH	object	Detail konfigurasi opsi SSH dan SFTP.
ExecCommand	string	Konfigurasi eksekusi perintah jarak jauh. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
SFTPChannel	string	Konfigurasi saluran SFTP. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
SFTPDownloadFile	string	Konfigurasi unduhan file SFTP. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
SFTPMkdir	string	Konfigurasi pembuatan folder SFTP. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
SFTPRemoveFile	string	Konfigurasi penghapusan file SFTP. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
SFTPRenameFile	string	Konfigurasi penggantian nama file SFTP. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
SFTPRmdir	string	Konfigurasi penghapusan folder SFTP. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
SFTPUploadFile	string	Konfigurasi unggahan file SFTP. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
SSHChannel	string	Konfigurasi saluran SSH. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
AllowDirectTcp	string	Apakah akan mengizinkan teknik tunneling TCP.	Enable
X11Forwarding	string	Konfigurasi penerusan X11. Nilai valid: Enable: Diaktifkan. Disable: Dinonaktifkan.	Enable
TcpForwarding	string	Apakah akan mengizinkan penerusan TCP.	Enable
AllowTcpForwarding	string	Apakah akan mengizinkan penerusan TCP.	Enable
ApprovalConfig	object	Detail konfigurasi persetujuan O&M.
SwitchStatus	string	Konfigurasi persetujuan O&M dalam kebijakan kontrol. Nilai valid: On: Persetujuan O&M diaktifkan. Off: Persetujuan O&M dinonaktifkan.	Off
RequestId	string	ID permintaan unik yang dihasilkan oleh Alibaba Cloud untuk permintaan ini.	0D29F2C0-8B4B-5861-9474-F3F23D25594B

Contoh

Respons sukses

JSONformat

{
  "Policy": {
    "AccessTimeRangeConfig": {
      "EffectiveTime": [
        {
          "Days": [
            "[2]"
          ],
          "Hours": [
            "[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]"
          ]
        }
      ]
    },
    "CommandConfig": {
      "Approval": {
        "Commands": [
          "ls"
        ]
      },
      "Deny": {
        "AclType": "black",
        "Commands": [
          "ls"
        ]
      }
    },
    "Comment": "comment",
    "IPAclConfig": {
      "AclType": "black",
      "IPs": [
        "[10.10.**.**]"
      ]
    },
    "PolicyName": "test",
    "PolicyId": "3",
    "Priority": 1,
    "ProtocolConfig": {
      "RDP": {
        "ClipboardDownload": "Enable",
        "ClipboardUpload": "Enable",
        "DiskRedirection": "Enable",
        "RecordKeyboard": "Enable",
        "DiskRedirectionUpload": "Enable",
        "DiskRedirectionDownload": "Enable"
      },
      "SSH": {
        "ExecCommand": "Enable",
        "SFTPChannel": "Enable",
        "SFTPDownloadFile": "Enable",
        "SFTPMkdir": "Enable",
        "SFTPRemoveFile": "Enable",
        "SFTPRenameFile": "Enable",
        "SFTPRmdir": "Enable",
        "SFTPUploadFile": "Enable",
        "SSHChannel": "Enable",
        "AllowDirectTcp": "Enable",
        "X11Forwarding": "Enable",
        "TcpForwarding": "Enable",
        "AllowTcpForwarding": "Enable"
      }
    },
    "ApprovalConfig": {
      "SwitchStatus": "Off"
    }
  },
  "RequestId": "0D29F2C0-8B4B-5861-9474-F3F23D25594B"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParameter	The argument is invalid.
500	InternalError	An unknown error occurred.
404	PolicyNotFound	The policy is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.