Data Management:Mengakses instans melalui HTTPS

Prasyarat

• secure access proxy telah diaktifkan untuk instance.

  Catatan

  Di Konsol DMS, navigasikan ke Security and Specifications > Secure Access Proxy. Pada tab Created, lihat daftar instans yang telah mengaktifkan secure access proxy. Jika perlu mengaktifkannya, lihat Enable the secure access proxy.

• Anda memiliki authorization untuk secure access proxy.

  Catatan

  Pada halaman detail secure access proxy, periksa status authorization untuk instance. Jika Anda tidak memiliki authorization, lihat Apply for secure access proxy authorization.

Pertimbangan penting

Instans secure-collaboration instance yang telah mengaktifkan secure access proxy tunduk pada aturan keamanan. Kami menyarankan agar Anda membatasi jumlah baris yang dikembalikan dalam satu kueri maksimal 3.000 baris. DMS tidak menjamin stabilitas untuk kueri yang mengembalikan lebih dari 3.000 baris.

Parameter permintaan

Bidang respons

API mengembalikan respons dalam format JSON.

Tabel berikut menjelaskan bidang-bidang dalam objek respons JSON.

Kode berikut menyediakan contoh respons.

• Kueri data yang berhasil

  {
    "columnMetas": [
      {
        "columnName":"column1",
        "columnLabel":"column1",
        "columnTypeName":"varchar",
        "precision":10,
        "scale":2,
        "nullable":true,
        "autoIncrement":true,
        "tableName":"table1"
      },
      {
        "columnName":"column2",
        "columnLabel":"column2",
        "columnTypeName":"varchar",
        "precision":10,
        "scale":2,
        "nullable":true,
        "autoIncrement":true,
        "tableName":"table1"
      } 
    ],
    "updateCount": 0,
    "requestId": "xhqej0xgcytbhc8scjopgqsywcaibi",
    "rowCount": 1,
    "rows": [
      {
        "col1": 1,
        "col2": "xxxx"
      }
    ],
    "success": true
  }

• Pembaruan data yang berhasil

  {
    "updateCount": 0,
    "requestId": "xhqej0xgcytbhc8scjopgqsywcaibi",
    "success": true
  }

• Permintaan gagal

  {
    "message": "accessId is required.",
    "requestId": "xhqej0xgcytbhc8scjopgqsywcaibi",
    "success": false
  }

Contoh

Anda dapat menggunakan command line, SQL client, atau kode aplikasi untuk mengakses instance yang telah mengaktifkan secure access proxy.

Asumsikan bahwa endpoint adalah dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com, nama database adalah database, AccessKey ID (dikirim sebagai accessId) adalah user, AccessKey Secret (dikirim sebagai accessSecret) adalah pwd, dan pernyataan SQL adalah show databases.

• Contoh perintah cURL

  # Permintaan GET
  curl 'https://[your_endpoint]/server/[your_database_name]?accessId=[your_AccessKey_ID]&accessSecret=[your_AccessKey_Secret]&sql=[your_sql_statement]'

  # Contoh permintaan GET
  curl 'https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database?accessId=user&accessSecret=pwd&sql=SHOW%20DATABASES'

  # Permintaan POST
  curl 'https://[your_endpoint]/server/[your_database_name]' -H 'accessId:[your_AccessKey_ID]' -H 'accessSecret:[your_AccessKey_Secret]' -H 'Content-Type:text/plain' -d '[your_sql_statement]'

  # Contoh permintaan POST
  curl 'https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database' -H 'accessId:user' -H 'accessSecret:pwd' -H 'Content-Type:text/plain' -d 'SHOW DATABASES'

• Contoh Python

  Catatan

  Contoh ini menggunakan Python 2.

  Permintaan GET:

  import requests
  
  url = "https://[your_endpoint]/server/[your_database_name]?accessId=[your_AccessKey_ID]&accessSecret=[your_AccessKey_Secret]&sql=[your_sql_statement]"
  print requests.get(url).text

  Contoh permintaan GET:

  import requests
  
  url = "https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database?accessId=user&accessSecret=pwd&sql=SHOW DATABASES"
  print requests.get(url).text

  Permintaan POST:

  import requests
  
  url = "https://[your_endpoint]/server/[your_database_name]"
  headers = {
      "Content-Type": "text/plain;charset=utf-8",
      "accessId": "[your_AccessKey_ID]",
      "accessSecret": "[your_AccessKey_Secret]"
  }
  print requests.post(url, headers=headers, data='[your_sql_statement]').text

  Contoh permintaan POST:

  import requests
  
  url = "https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database"
  headers = {
      "Content-Type": "text/plain;charset=utf-8",
      "accessId": "user",
      "accessSecret": "pwd"
  }
  print requests.post(url, headers=headers, data='SHOW DATABASES').text

• Contoh Node.js

  Permintaan GET:

  const https = require("https");
  
  https.get("https://[your_endpoint]/server/[your_database_name]?accessId=[your_AccessKey_ID]&accessSecret=[your_AccessKey_Secret]&sql=SHOW DATABASES", resp => {
      resp.on("data", data => {
          console.log(JSON.parse(data));
      });
  });

  Contoh permintaan GET:

  const https = require("https");
  
  https.get("https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database?accessId=user&accessSecret=pwd&sql=SHOW DATABASES", resp => {
      resp.on("data", data => {
          console.log(JSON.parse(data));
      });
  });

  Permintaan POST:

  const https = require("https");
  
  var req = https.request({
      hostname: '[your_endpoint]',
      port: 443,
      path: '/server/[your_database_name]',
      method: 'POST',
      headers: {
          'Content-Type': 'text/plain; charset=UTF-8',
          accessId: '[your_AccessKey_ID]',
          accessSecret: '[your_AccessKey_Secret]'
      }
  }, resp => {
      resp.on("data", data => {
          console.log(JSON.parse(data));
      });
  });
  req.write("[your_sql_statement]");
  req.end();

  Contoh permintaan POST:

  const https = require("https");
  
  var req = https.request({
      hostname: 'dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com',
      port: 443,
      path: '/server/database',
      method: 'POST',
      headers: {
          'Content-Type': 'text/plain; charset=UTF-8',
          accessId: 'user',
          accessSecret: 'pwd'
      }
  }, resp => {
      resp.on("data", data => {
          console.log(JSON.parse(data));
      });
  });
  req.write("SHOW DATABASES");
  req.end();

• Contoh Postman

  Permintaan GET:

  Permintaan POST: