Data Management:Accéder à une instance via HTTPS

Prérequis

• Le proxy d'accès sécurisé est activé pour l'instance.

  Remarque

  Affichez les instances pour lesquelles le proxy d'accès sécurisé est activé dans l'onglet Created de la page Security and Specifications > Secure Access Proxy. Pour activer cette fonctionnalité, consultez la rubrique Activer le proxy d'accès sécurisé.

• Vous êtes autorisé à utiliser le proxy d'accès sécurisé.

  Remarque

  Vérifiez votre statut d'autorisation pour l'instance sur la page de détails du proxy d'accès sécurisé. Si vous n'êtes pas autorisé, consultez la rubrique Demander une autorisation pour le proxy d'accès sécurisé.

Remarques d'utilisation

Des règles de sécurité s'appliquent aux instances pour lesquelles le proxy d'accès sécurisé et la collaboration sécurisée sont tous deux activés. Nous vous recommandons de limiter chaque requête à un maximum de 3 000 lignes renvoyées. Data Management Service (DMS) ne peut pas garantir la stabilité si une requête renvoie un trop grand nombre de lignes.

Paramètres de requête

Format de réponse

Lorsque vous accédez à l'instance via HTTPS, la réponse est renvoyée au format JSON.

L'objet JSON présente la structure suivante :

Voici des exemples de réponses :

• Requête réussie

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

• Mise à jour réussie

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

• Échec de la requête

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

Exemples

Utilisez la ligne de commande, un client SQL ou du code applicatif pour accéder à une instance dont le proxy d'accès sécurisé est activé.

Les exemples suivants utilisent les valeurs suivantes : l'endpoint est dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com, le nom de la base de données est database, l'ID AccessKey est user, la clé secrète AccessKey est pwd et la commande SQL est SHOW DATABASES.

• Utiliser la commande 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'

• Utiliser un programme Python

  Remarque

  Cet exemple utilise Python 2.

  Requête GET :

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

  Exemple de requête 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

  Requête POST :

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

  Exemple de requête 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

• Utiliser un programme Node.js

  Requête GET :

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

  Exemple de requête 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));
      });
  });

  Requête 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();

  Exemple de requête 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();

• Utiliser le client Postman

  Requête GET : dans Postman, envoyez une requête GET à l'URL https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/. Dans les paramètres d'URL, définissez accessId sur votre ID AccessKey, accessSecret sur votre clé secrète AccessKey et sql sur l'instruction SQL que vous souhaitez exécuter, par exemple SHOW DATABASES. Cliquez sur Send.

  Requête POST : dans Postman, définissez la méthode de requête sur POST et l'URL sur https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/. Dans l'onglet Headers, ajoutez les en-têtes suivants : définissez Content-Type sur text/plain, accessId sur votre ID AccessKey et accessSecret sur votre clé secrète AccessKey. Dans l'onglet Body, sélectionnez raw, choisissez Text et saisissez l'instruction SQL, par exemple SHOW DATABASES, dans la zone de texte. Cliquez sur Send.