All Products
Search

This Product

    Hologres:GetInstance

    Document Center

    Hologres:GetInstance

    Last Updated:Sep 17, 2026

    Mengambil detail instans.

    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

    hologram:GetInstance

    get

    *Instans.

    acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

    		 None None

    Sintaks permintaan

    GET /api/v1/instances/{instanceId} HTTP/1.1

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example
    instanceId

    string

    No

    ID instans. Parameter ini wajib diisi.

    hgprecn-cn-i7m2v08uu00a

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example

    Tidak ada parameter yang diperlukan.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    865A02C2-B374-5DD4-9B34-0CA15DA1AEBD
    Instance

    object

    Informasi instans.

    InstanceChargeType

    string

    Metode penagihan instans.

    Valid values:

    • PostPaid :

      bayar sesuai pemakaian.

    • PrePaid :

      berlangganan.

    PrePaid
    CommodityCode

    string

    Kode komoditas.

    Valid values:

    • hologram_maxcomputeAccelerate_public_cn :

      situs Tiongkok / akselerasi data lake.

    • hologram_combo_public_cn :

      situs Tiongkok / berlangganan.

    • hologram_prepay_public_intl :

      situs internasional / berlangganan.

    • hologram_storage_dp_cn :

      situs Tiongkok / rencana pengurangan penyimpanan.

    • hologram_postpay_public_cn :

      situs Tiongkok / bayar sesuai pemakaian.

    • hologram_postpay_public_intl :

      situs internasional / bayar sesuai pemakaian.

    • hologram_maxcomputeAccelerate_public_intl :

      situs internasional / akselerasi data lake.

    • hologram_cu_dp_cn :

      situs Tiongkok / rencana pengurangan komputasi.

    hologram_combo_public_cn
    Cpu

    integer

    Jumlah inti CPU.

    32
    CreationTime

    string

    Pengatur waktu pembuatan. Pengatur waktu menggunakan standar ISO 8601 dalam UTC.

    2021-02-03T13:06:06Z
    Disk

    string

    Ukuran penyimpanan standar.

    Unit: GB.

    500
    Endpoints

    array<object>

    Daftar titik akhir.

    object

    Detail titik akhir.

    Endpoint

    string

    Titik akhir.

    hgprecn-cn-uqm362o1b001-cn-hangzhou-internal.hologres.aliyuncs.com:80
    Type

    string

    Jenis jaringan.

    Valid values:

    • VPCSingleTunnel :

      VPC.

    • Intranet :

      jaringan internal.

    • VPCAnyTunnel :

      tidak didukung untuk instans baru.

    • Internet :

      Internet.

    Internet
    Enabled

    boolean

    Apakah jaringan diaktifkan.

    Valid values:

    • true :

      Diaktifkan.

    • false :

      Dinonaktifkan.

    true
    VSwitchId

    string

    ID vSwitch.

    vsw-bp1jqwp2ys6kp7tc9t983
    VpcId

    string

    ID VPC.

    vpc-uf66jjber3hgvwhki3wna
    VpcInstanceId

    string

    ID instans VPC.

    hgprecn-cn-uqm362o1b001-frontend-st
    AlternativeEndpoints

    string

    Beberapa instans lama memiliki AnyTunnel dan SingleTunnel yang diaktifkan. Saat beralih dari AnyTunnel ke SingleTunnel, kedua titik akhir dipertahankan. Bidang ini menyimpan titik akhir tambahan.

    hgprecn-cn-uqm362o1b001-cn-hangzhou-internal.hologres.aliyuncs.com:80
    ExpirationTime

    string

    Pengatur waktu kedaluwarsa. Pengatur waktu menggunakan standar ISO 8601 dalam UTC.

    Instans bayar sesuai pemakaian tidak memiliki pengatur waktu kedaluwarsa.

    2021-02-03T13:06:06Z
    InstanceId

    string

    ID instans.

    hgpostcn-cn-tl32s6cgw00b
    InstanceName

    string

    Nama instans. Panjang nama adalah 2 hingga 64 karakter. Setiap huruf atau karakter Tiongkok dihitung sebagai satu karakter.

    test
    InstanceType

    string

    Tipe instans.

    Valid values:

    • Warehouse :

      kelompok komputasi.

    • Follower :

      instans sekunder hanya baca.

    • Standard :

      standar.

    • Serverless :

      serverless.

    • Shared :

      bersama.

    Standard
    Memory

    integer

    Ukuran memori.

    Unit: GB.

    128
    InstanceOwner

    string

    Pemilik instans.

    12345678900000
    InstanceStatus

    string

    Status instans.

    Valid values:

    • Creating :

      Sedang dibuat.

    • Running :

      Berjalan.

    • Suspended :

      Ditangguhkan.

    • Allocating :

      Sedang diproses.

    Running
    Version

    string

    Versi instans.

    r1.3.37
    SuspendReason

    string

    Alasan penangguhan.

    Valid values:

    • Indebet :

      Pembayaran tertunda.

    • Manual :

      Ditangguhkan secara manual.

    • Overdue :

      Langganan kedaluwarsa.

    Manual
    Tags

    array<object>

    Tag instans.

    object

    Detail tag.

    Key

    string

    Kunci tag.

    tag
    Value

    string

    Nilai tag.

    value
    LeaderInstanceId

    string

    ID instans utama.

    hgpostcn-cn-i7m2ncd6w002
    EnableHiveAccess

    string

    Apakah akselerasi data lake diaktifkan.

    true
    ResourceGroupId

    string

    ID kelompok sumber daya.

    rg-aekzuq7hpybze2i
    ComputeNodeCount

    integer

    Jumlah node komputasi. Konfigurasi tipikal untuk node tunggal adalah 16 inti dan memori 32 GB.

    2
    ZoneId

    string

    ID zona.

    cn-hangzhou-h
    ColdStorage

    integer

    Kapasitas penyimpanan dingin.

    Unit: GB. SSD setara dengan penyimpanan panas, yang juga merupakan penyimpanan standar. HDD setara dengan penyimpanan dingin.

    800
    AutoRenewal

    string

    Apakah perpanjangan otomatis diaktifkan.

    Valid values:

    • true :

      Perpanjangan otomatis diaktifkan.

    • false :

      Perpanjangan otomatis dinonaktifkan.

    true
    GatewayCount

    integer

    Jumlah node gerbang.

    2
    GatewayCpu

    integer

    Sumber daya CPU gerbang.

    Unit: core.

    4
    GatewayMemory

    integer

    Sumber daya memori gerbang.

    Unit: GB.

    16
    RegionId

    string

    ID wilayah.

    cn-hangzhou
    ReplicaRole

    string

    Peran instans pemulihan bencana. Nilai valid:

    • Active: instans pemulihan bencana utama.

    • Passive: instans pemulihan bencana cadangan.

    • PreActive: instans pemulihan bencana utama yang belum mencapai status yang diinginkan.

    Active
    EnableServerless

    boolean

    Apakah ServerlessComputing diaktifkan.

    Valid values:

    • true :

      Diaktifkan.

    • false :

      Dinonaktifkan.

    true
    StorageType

    string

    Jenis penyimpanan. Nilai valid:

    • redundant: Penerapan tiga zona.

    • local: Penerapan zona tunggal.

    redundant
    EnableSSL

    boolean

    Apakah SSL diaktifkan.

    true
    Success

    boolean

    Hasil permintaan, yang menunjukkan apakah permintaan mengalami pengecualian. Hal ini tidak terkait dengan logika bisnis.

    true
    ErrorCode

    string

    Kode kesalahan.

    null
    ErrorMessage

    string

    Paket kesalahan.

    null
    HttpStatusCode

    string

    Kode status HTTP.

    200

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "865A02C2-B374-5DD4-9B34-0CA15DA1AEBD",
  "Instance": {
    "InstanceChargeType": "PrePaid",
    "CommodityCode": "hologram_combo_public_cn",
    "Cpu": 32,
    "CreationTime": "2021-02-03T13:06:06Z",
    "Disk": "500",
    "Endpoints": [
      {
        "Endpoint": "hgprecn-cn-uqm362o1b001-cn-hangzhou-internal.hologres.aliyuncs.com:80",
        "Type": "Internet",
        "Enabled": true,
        "VSwitchId": "vsw-bp1jqwp2ys6kp7tc9t983",
        "VpcId": "vpc-uf66jjber3hgvwhki3wna",
        "VpcInstanceId": "hgprecn-cn-uqm362o1b001-frontend-st",
        "AlternativeEndpoints": "hgprecn-cn-uqm362o1b001-cn-hangzhou-internal.hologres.aliyuncs.com:80"
      }
    ],
    "ExpirationTime": "2021-02-03T13:06:06Z",
    "InstanceId": "hgpostcn-cn-tl32s6cgw00b",
    "InstanceName": "test",
    "InstanceType": "Standard",
    "Memory": 128,
    "InstanceOwner": "12345678900000",
    "InstanceStatus": "Running",
    "Version": "r1.3.37",
    "SuspendReason": "Manual",
    "Tags": [
      {
        "Key": "tag",
        "Value": "value"
      }
    ],
    "LeaderInstanceId": "hgpostcn-cn-i7m2ncd6w002",
    "EnableHiveAccess": "true",
    "ResourceGroupId": "rg-aekzuq7hpybze2i",
    "ComputeNodeCount": 2,
    "ZoneId": "cn-hangzhou-h",
    "ColdStorage": 800,
    "AutoRenewal": "true",
    "GatewayCount": 2,
    "GatewayCpu": 4,
    "GatewayMemory": 16,
    "RegionId": "cn-hangzhou",
    "ReplicaRole": "Active",
    "EnableServerless": true,
    "StorageType": "redundant",
    "EnableSSL": true
  },
  "Success": true,
  "ErrorCode": "null",
  "ErrorMessage": "null",
  "HttpStatusCode": "200"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.