Data Management:Acesse uma instância via HTTPS

Pré-requisitos

• O proxy de acesso seguro está ativado para a instância.

  Nota

  Visualize as instâncias com o proxy de acesso seguro ativado na aba Created da página Security and Specifications > Secure Access Proxy. Para ativar esse recurso, consulte Ativar o proxy de acesso seguro.

• Você tem autorização para usar o proxy de acesso seguro.

  Nota

  Verifique seu status de autorização para a instância na página de detalhes do proxy de acesso seguro. Caso não tenha autorização, consulte Solicitar autorização do proxy de acesso seguro.

Observações de uso

Regras de segurança aplicam-se a instâncias com o proxy de acesso seguro e os recursos de colaboração segura ativados. Recomendamos limitar cada consulta a no máximo 3.000 linhas. O Data Management Service (DMS) não garante estabilidade se uma consulta retornar um volume excessivo de linhas.

Parâmetros da solicitação

Formato da resposta

Ao acessar a instância via HTTPS, o sistema retorna a resposta no formato JSON.

O objeto JSON tem a seguinte estrutura:

Veja a seguir exemplos de respostas:

• Consulta bem-sucedida

  {
    "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
  }

• Atualização bem-sucedida

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

• Falha na solicitação

  {
    "message": 'AccessKey ID is required.',
    "requestId": "xhqej0xgcytbhc8scjopgqsywcaibi",
    "success": false
  }

Exemplos

Use a linha de comando, um cliente SQL ou código de aplicativo para acessar uma instância com o proxy de acesso seguro ativado.

Os exemplos a seguir utilizam estes valores: endpoint dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com, nome do banco de dados database, AccessKey ID user, AccessKey Secret pwd e comando SQL SHOW DATABASES.

• Comando curl

  # GET request
  curl 'https:///server/?accessId=&accessSecret=&sql='

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

  # POST request
  curl 'https:///server/' -H 'accessId:' -H 'accessSecret:' -H 'Content-Type:text/plain' -d ''

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

• Programa Python

  Nota

  Este exemplo usa Python 2.

  Solicitação GET:

  import requests
  url = "https:///server/?accessId=&accessSecret=&sql="
  print requests.get(url).text

  Exemplo de solicitação 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

  Solicitação POST:

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

  Exemplo de solicitação 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

• Programa Node.js

  Solicitação GET:

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

  Exemplo de solicitação 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));
      });
  });

  Solicitação POST:

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

  Exemplo de solicitação 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();

• Cliente Postman

  Solicitação GET: No Postman, envie uma solicitação GET para a URL https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/. Nos parâmetros da URL, defina accessId como seu AccessKey ID, accessSecret como seu AccessKey Secret e sql como a instrução SQL desejada, por exemplo, SHOW DATABASES. Clique em Send.

  Solicitação POST: No Postman, defina o método de solicitação como POST e a URL como https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/. Na aba Headers, adicione os seguintes cabeçalhos: defina Content-Type como text/plain, accessId como seu AccessKey ID e accessSecret como seu AccessKey Secret. Na aba Body, selecione raw, escolha Text e insira a instrução SQL, por exemplo, SHOW DATABASES, na área de texto. Clique em Send.