Getting Information About Your Server Certificates

You can get information about your server certificates uploaded in EIM, like their IDs or OUTSCALE Resource Names.

Using AWS CLI, you can also get information about the content of a server certificate like its certificate body or certification chain.

Getting Information About Your Server Certificates Using OSC CLI

The ReadServerCertificates command lists your server certificates.

Request sample
$ osc-cli api ReadServerCertificates --profile "default" \
    --Filters '{
        "Paths": ["/example/"],
      }'

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Filters: (optional) One or more filters.

    • Paths: (optional) The paths to the server certificates.

The ReadServerCertificates command returns the following elements:

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

  • ServerCertificates: Information about one or more server certificates.

    • ExpirationDate: The date on which the server certificate expires.

    • Id: The ID of the server certificate.

    • Name: The name of the server certificate.

    • Orn: The OUTSCALE Resource Name (ORN) of the server certificate. For more information, see Resource Identifiers > OUTSCALE Resource Names (ORNs).

    • Path: The path to the server certificate.

    • UploadDate: The date on which the server certificate has been uploaded.

Result sample
{
  "ServerCertificates": [
    {
      "Path": "/example/",
      "Id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234",
      "Orn": "orn:ows:idauth::012345678910:server-certificate/example/server-cert-example",
      "Name": "server-cert-example"
    }
  ],
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Getting Information About Server Certificates Using AWS CLI

Getting Information About a Specific Server Certificate Using AWS CLI

To get information about a server certificate, use the get-server-certificate command following this syntax:

Request sample
$ aws iam get-server-certificate \
    --profile YOUR_PROFILE \
    --server-certificate-name my-server-certificate \
    --endpoint https://eim.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • server-certificate-name: The name of the certificate.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The get-server-certificate command returns the following elements:

  • ServerCertificate: Information about the server certificate. This element contains the following information:

    • CertificateBody: The PEM-encoded x509 certificate.

    • CertificateChain: The PEM-encoded chain of intermediate certification authorities.

    • ServerCertificateMetadata: The metadata of the server certificate. This element contains the following information:

      • Arn: The OUTSCALE Resource Name (ORN) of the server certificate.

      • Path: The path to the server certificate.

      • ServerCertificateId: The ID of the server certificate, generated by EIM.

      • ServerCertificateName: The name of the server certificate.

Result sample
{
   "ServerCertificate":
                       {
                         "CertificateBody": "...",
                         "CertificateChain": "...",
                         "ServiceCertificateMetadata":
                                                      {
                                                       "Arn": "my_load_balancer_1234567890.lbu.eu-west-2.outscale.com",
                                                       "Path": "/division/subdivision",
                                                       "ServerCertificateId": "ABCDEFGHIJK1L2MNOPQRS",
                                                       "ServerCertificateName": "my-server-certificate",
                                                      }
                      }
}

Listing Your Server Certificates Using AWS CLI

To list your server certificates, use the list-server-certificates command following this syntax:

Request sample
$ aws iam list-server-certificates \
    --profile YOUR_PROFILE \
    --path-prefix /division/subdivision \
    --endpoint https://eim.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • (optional) path-prefix: The path prefix of the server certificates, set to a slash (/) if not specified.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The list-server-certificates command returns the following elements:

  • ServerCertificateMetadataList: The metadata of one or more server certificates. This element contains the following information:

    • Arn: The OUTSCALE Resource Name (ORN) of the server certificate.

    • Path: The path to the server certificate.

    • ServerCertificateId: The ID of the server certificate, generated by EIM.

    • ServerCertificateName: The name of the server certificate.

Result sample
{
   "ServerCertificateMetadataList":[
                                    {
                                     "Arn": "my_load_balancer_1234567890.lbu.eu-west-2.outscale.com",
                                     "Path": "/division/subdivision",
                                     "ServerCertificateId": "ABCDEFGHIJK1L2MNOPQRS",
                                     "ServerCertificateName": "my-server-certificate",
                                    }
                                   ]
}

Related Pages

Corresponding API Method

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.