Lister les certificats

GET /api/servers/(string: server)/accounts/(string: login)/certificates

Renvoie une liste des certificats emplissant les critères donnés en paramètres de requête.

En-têtes de requête:
Paramètres:
  • limit (int) – Le nombre maximum de résultats souhaités (défaut: 20)

  • offset (int) – Le numéro du premier résultat souhaité (défaut: 0)

  • sort ([name+|name-]) – Le paramètre selon lequel les certificats seront triés (défaut: name+)

Status Codes:
  • 200 OK – La liste a été renvoyée avec succès

  • 400 Bad Request – Un ou plusieurs des paramètres de requêtes sont invalides

  • 401 Unauthorized – Authentification d’utilisateur invalide

  • 404 Not Found – Le partenaire demandé n’existe pas

Objet JSON de réponse:
  • certificates (array) – La liste des certificats demandés

Tableau d’objets JSON de réponse:
  • name (string) – Le nom du certificat

  • privateKey (string) – La clé privée du certificat en format PEM

  • certificate (string) – Le certificat de l’entité en format PEM (mutuellement exclusif avec public_key)

  • publicKey (string) – La clé publique SSH de l’entité en format authorized_key (mutuellement exclusif avec certificate)


Exemple de requête

GET https://my_waarp_gateway.net/api/servers/gw_r66/accounts/toto/certificates/certificat_toto?limit=5 HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Exemple de réponse

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 453

{
  "certificates": [{
    "name": "certificat_toto",
    "certificate": "-----BEGIN CERTIFICATE-----
      MIICPDCCAaWgAwIBAgIRAMozibNPf0LHnyUC25vjrzQwDQYJKoZIhvcNAQELBQAw
      EjEQMA4GA1UEChMHQWNtZSBDbzAgFw03MDAxMDEwMDAwMDBaGA8yMDg0MDEyOTE2
      MDAwMFowEjEQMA4GA1UEChMHQWNtZSBDbzCBnzANBgkqhkiG9w0BAQEFAAOBjQAw
      gYkCgYEAzAWD0DQX+nwfZcM3ZRnAAjAxCBM5SOsmMsr9rrgdXkZVrJ+e2obw3wYU
      kWNtmzCE4oKLgkXz7amrc4Z5MfJ/UROGURDge/PwWRa6PgCyHQK2TA2vup1GH16n
      +2uE7gOtCPHzENGIsN2bqHx9suO+NsO2+56A/AulQfNLYYEszbcCAwEAAaOBjzCB
      jDAOBgNVHQ8BAf8EBAMCAqQwEwYDVR0lBAwwCgYIKwYBBQUHAwEwDwYDVR0TAQH/
      BAUwAwEB/zAdBgNVHQ4EFgQU3Dn86/SOlQoDldWdm3831wOsGKwwNQYDVR0RBC4w
      LIIOMTI3LjAuMC4xOjY2NjaCCls6OjFdOjY2NjaCDmxvY2FsaG9zdDo2NjY2MA0G
      CSqGSIb3DQEBCwUAA4GBAFFL4e0IBbdxK8ohjnZz5c5PuCXzQy14fqVCozcHGVaf
      SKpWXKwjJnCpAmgzgwz60wFQuXAZNMxhCSTOxsuHrgJb+8EBNwiB8L1QNvI0TwQj
      7a9xLI4RZOju8VUANmTztJajWV+29Hs4fJkHKZtPvMhOAt0SWp1D9lxB6ChxY5c3
      -----END CERTIFICATE-----"
  }]
}