All Products
Search
Document Center

Bastionhost:GenerateAssetOperationToken

Last Updated:Oct 09, 2026

Mengajukan token O&M host atau database untuk melakukan operasi O&M pada aset.

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

get

*Semua sumber daya.

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

ID instans Host Bastion tempat Anda ingin mengajukan token O&M.

Catatan

Anda dapat memanggil operasi DescribeInstances untuk mendapatkan nilai parameter ini.

bastionhost-cn-st220aw****

RegionId

string

No

ID wilayah Instans Host Bastion.

Catatan

Untuk informasi selengkapnya mengenai pemetaan antara ID wilayah dan nama wilayah, lihat Wilayah dan zona.

cn-hangzhou

AssetType

string

Yes

Jenis aset tempat Anda ingin mengajukan token. Nilai valid:

  • Host: host

  • Database: database

Host

AssetId

string

Yes

ID aset tempat Anda ingin mengajukan token O&M.

11

AssetAccountId

string

No

ID akun aset tempat Anda ingin mengajukan token O&M.

Catatan

Anda harus menentukan setidaknya satu dari AssetAccountId dan AssetAccountName. Jika keduanya ditentukan, AssetAccountId akan diutamakan.

2

AssetAccountName

string

No

Nama akun Host. Jika akun adalah akun kustom, tentukan nama akun sebenarnya.

Catatan

Jika AssetAccountId dan AssetAccountName keduanya ditentukan, AssetAccountId akan diutamakan.

root

AssetAccountPassword

string

No

Kata sandi yang dienkode Base64. Parameter ini wajib diisi saat Anda mengajukan token O&M untuk akun kustom.

dGVzdHBhc3N3b3Jk

AssetAccountProtocolName

string

No

Nama protokol. Nilai valid:

  • SSH

  • RDP

  • Oracle

  • PostgreSQL

  • MySQL

  • SQLServer

Catatan

Parameter ini wajib diisi saat Anda mengajukan token O&M untuk akun kustom.

SSH

OperationMode

string

No

Metode logon O&M. Nilai valid:

  • WebToken: mendapatkan token O&M

  • Sso: logon menggunakan klien lokal

Catatan

Parameter ini hanya didukung di Host Bastion V3.2.44 dan versi yang lebih baru. Jika parameter ini dikosongkan, nilai default WebToken akan digunakan.

Valid values:

  • Sso :

    Logon menggunakan klien lokal.

  • WebToken :

    Mendapatkan token O&M.

Sso

LoginAttribute

string

No

Atribut logon. Parameter ini wajib diisi saat OperationMode diatur ke Sso dan akun adalah akun Oracle kustom. Nilai valid:

  • SERVICENAME

  • SID

Catatan

Parameter ini hanya didukung di Host Bastion V3.2.44 dan versi yang lebih baru.

Valid values:

  • SERVICENAME :

    Nama layanan.

  • SID :

    SID.

SID

DatabaseSchema

string

No

Nama database. Parameter ini wajib diisi saat OperationMode diatur ke Sso, AssetAccountProtocolName diatur ke PostgreSQL atau Oracle, dan akun adalah akun kustom.

Catatan

Parameter ini hanya didukung di Host Bastion V3.2.44 dan versi yang lebih baru.

orcl

SsoClient

string

No

Tipe klien lokal yang akan dibuka untuk operasi O&M pada aset Linux. Parameter ini wajib diisi saat OperationMode diatur ke Sso dan protokol aset adalah SSH. Nilai valid:

  • ssh: membuka klien SSH untuk melakukan operasi O&M dengan izin SSH

  • sftp: membuka klien SFTP untuk melakukan operasi O&M dengan izin SFTP

Catatan

Parameter ini hanya didukung di Host Bastion V3.2.44 dan versi yang lebih baru.

Valid values:

  • ssh :

    Klien SSH.

  • sftp :

    Klien SFTP.

ssh

OperationNote

string

No

Catatan logon. Parameter ini wajib diisi saat administrator mengaktifkan fitur catatan logon di kebijakan kontrol.

comment

Elemen respons

Element

Type

Description

Example

object

AssetOperationToken

object

Data tanggapan.

CountLeft

integer

Sisa jumlah kali token O&M dapat digunakan.

1

ExpireTime

integer

Waktu kedaluwarsa token O&M. Nilainya adalah stempel waktu UNIX.

1709110797

HasCountLimit

boolean

Apakah jumlah penggunaan dibatasi.

true

MaxRenewCount

integer

Jumlah maksimum kali token dapat diperbarui. Nilai 0 menunjukkan bahwa token tidak dapat diperbarui.

10

RenewCount

integer

Jumlah kali token telah diperbarui.

1

Token

string

Token O&M yang diminta.

NmYyMmEzNmMwYzljNGY******

TokenId

string

ID token O&M.

1

SsoUrl

string

URL Single Sign-On (SSO).

sso://eyJOT0RFX0NPTU1PTiI6eyJNb2R******

RequestId

string

ID permintaan.

EC9BF0F4-8983-491A-BC8C-1B4DD94976DE

Contoh

Respons sukses

JSONformat

{
  "AssetOperationToken": {
    "CountLeft": 1,
    "ExpireTime": 1709110797,
    "HasCountLimit": true,
    "MaxRenewCount": 10,
    "RenewCount": 1,
    "Token": "NmYyMmEzNmMwYzljNGY******",
    "TokenId": "1",
    "SsoUrl": "sso://eyJOT0RFX0NPTU1PTiI6eyJNb2R******"
  },
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE"
}

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.