Class ListServerCertificatesCommandProtected

Lists the server certificates stored in IAM that have the specified path prefix. If none exist, the operation returns an empty list.

You can paginate the results using the MaxItems and Marker parameters.

For more information about working with server certificates, see Working with server certificates in the IAM User Guide. This topic also includes a list of Amazon Web Services services that can use the server certificates that you manage with IAM.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a servercertificate, see GetServerCertificate.

Example

Use a bare-bones client and the command you need to make an API call.

import { IAMClient, ListServerCertificatesCommand } from "@aws-sdk/client-iam"; // ES Modules import
// const { IAMClient, ListServerCertificatesCommand } = require("@aws-sdk/client-iam"); // CommonJS import
const client = new IAMClient(config);
const input = { // ListServerCertificatesRequest
  PathPrefix: "STRING_VALUE",
  Marker: "STRING_VALUE",
  MaxItems: Number("int"),
};
const command = new ListServerCertificatesCommand(input);
const response = await client.send(command);
// { // ListServerCertificatesResponse
//   ServerCertificateMetadataList: [ // serverCertificateMetadataListType // required
//     { // ServerCertificateMetadata
//       Path: "STRING_VALUE", // required
//       ServerCertificateName: "STRING_VALUE", // required
//       ServerCertificateId: "STRING_VALUE", // required
//       Arn: "STRING_VALUE", // required
//       UploadDate: new Date("TIMESTAMP"),
//       Expiration: new Date("TIMESTAMP"),
//     },
//   ],
//   IsTruncated: true || false,
//   Marker: "STRING_VALUE",
// };

Param

ListServerCertificatesCommandInput

Returns

ListServerCertificatesCommandOutput

See

• ListServerCertificatesCommandInput for command's input shape.
• ListServerCertificatesCommandOutput for command's response shape.
• config for IAMClient's config shape.

Throws

ServiceFailureException (server fault)

The request processing has failed because of an unknown error, exception or failure.

Throws

IAMServiceException

Base exception class for all service exceptions from IAM service.