All Products
Search
Document Center

Data Management:GetInstance

Last Updated:Mar 21, 2026

Mendapatkan detail instans 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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

Tid

integer

No

ID penyewa. Panggil operasi GetUserActiveTenant untuk mendapatkan nilai ini.

2***

Host

string

Yes

Titik akhir instans. Panggil operasi ListInstances untuk mendapatkan nilai ini.

172.17.XXX.XXX

Port

integer

Yes

Port instans. Panggil operasi ListInstances untuk mendapatkan nilai ini.

5432

Sid

string

No

SID instans. Panggil operasi ListInstances untuk mendapatkan nilai ini.

test

RealLoginUserUid

string

No

Parameter ini dicadangkan.

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

F6C80B69-3203-56AC-8021-18BA72A6F4E1

Instance

object

Detail mengenai instans.

VpcId

string

ID VPC tempat instans berada.

vpc-o6wrloqsdqc9io3mg****

DatabaseUser

string

Username yang digunakan untuk login ke instans.

dbuser

DbaId

string

ID administrator basis data (DBA) instans.

29****

UseDsql

integer

Menunjukkan apakah kueri lintas database diaktifkan untuk instans. Nilai yang valid:

  • 0: dinonaktifkan

  • 1: diaktifkan

0

Port

integer

Port yang digunakan untuk menghubungkan ke instans.

5432

EcsInstanceId

string

ID Instance ECS tempat instans database dideploy.

i-bp124ldpklqz59y3****

EnvType

string

Jenis lingkungan tempat instans berada. Nilai yang valid:

  • product: lingkungan produksi

  • dev: lingkungan pengembangan

  • pre: lingkungan pra-rilis

  • test: lingkungan pengujian

  • sit: lingkungan pengujian integrasi sistem (SIT)

  • uat: lingkungan pengujian penerimaan pengguna (UAT)

  • pet: lingkungan pengujian performa

  • stag: lingkungan staging

test

Sid

string

ID sistem (SID) instans.

test

OwnerIdList

object

ID pemilik instans.

OwnerIds

array

ID pengguna dari pemilik instans.

string

ID pengguna dari salah satu pemilik instans.

10****

SafeRuleId

string

ID aturan keamanan yang ditetapkan untuk instans.

3****

OwnerNameList

object

Nama panggilan pemilik instans.

OwnerNames

array

Nama panggilan pemilik instans.

string

Nama panggilan salah satu pemilik instans.

yang_test

DbaNickName

string

Nama panggilan DBA instans.

dbaname

QueryTimeout

integer

Periode timeout untuk mengkueri data dalam instans. Satuan: detik.

7200

InstanceSource

string

Sumber instans.

ECS_OWN

Host

string

Titik akhir yang digunakan untuk menghubungkan ke instans.

192.168.XXX.XXX

State

string

Status instans. Nilai yang valid:

  • NORMAL: Instans berjalan normal.

  • DISABLE: Instans dinonaktifkan.

NORMAL

DataLinkName

string

Nama tautan data untuk instans.

test

ExportTimeout

integer

Periode timeout untuk mengekspor data dari instans. Satuan: detik.

86400

InstanceId

string

ID instans.

188****

InstanceType

string

Jenis database.

postgresql

DatabasePassword

string

Password yang sesuai dengan username tersebut.

******

InstanceAlias

string

Alias instans.

测试

DdlOnline

integer

Menunjukkan apakah perubahan skema tanpa lock diaktifkan untuk instans.

0

EcsRegion

string

Wilayah tempat instans berada.

cn-beijing

StandardGroup

object

Mode kontrol instans.

GroupName

string

Nama aturan keamanan yang sesuai dengan mode kontrol.

自由操作

GroupMode

string

Mode kontrol. Nilai yang valid:

  • COMMON: Security Collaboration

  • NONE_CONTROL: Flexible Management

  • STABLE: Stable Change

NONE_CONTROL

SellSitd

string

Menunjukkan apakah perlindungan data sensitif diaktifkan. Nilai yang valid:

  • true: diaktifkan

  • false: dinonaktifkan

false

SellTrust

string

Parameter ini dicadangkan.

ErrorCode

string

Kode kesalahan yang dikembalikan.

UnknownError

ErrorMessage

string

Pesan kesalahan yang dikembalikan.

UnknownError

Success

boolean

Menunjukkan apakah permintaan berhasil. Nilai yang valid:

  • true

  • false

true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F6C80B69-3203-56AC-8021-18BA72A6F4E1",
  "Instance": {
    "VpcId": "vpc-o6wrloqsdqc9io3mg****",
    "DatabaseUser": "dbuser",
    "DbaId": "29****",
    "UseDsql": 0,
    "Port": 5432,
    "EcsInstanceId": "i-bp124ldpklqz59y3****",
    "EnvType": "test",
    "Sid": "test",
    "OwnerIdList": {
      "OwnerIds": [
        "10****"
      ]
    },
    "SafeRuleId": "3****",
    "OwnerNameList": {
      "OwnerNames": [
        "yang_test"
      ]
    },
    "DbaNickName": "dbaname",
    "QueryTimeout": 7200,
    "InstanceSource": "ECS_OWN",
    "Host": "192.168.XXX.XXX",
    "State": "NORMAL",
    "DataLinkName": "test",
    "ExportTimeout": 86400,
    "InstanceId": "188****",
    "InstanceType": "postgresql",
    "DatabasePassword": "******",
    "InstanceAlias": "测试",
    "DdlOnline": 0,
    "EcsRegion": "cn-beijing",
    "StandardGroup": {
      "GroupName": "自由操作",
      "GroupMode": "NONE_CONTROL"
    },
    "SellSitd": "false",
    "SellTrust": ""
  },
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "Success": true
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.