Class AWS::IAM::ServerCertificateCollection
In: lib/aws/iam/server_certificate_collection.rb
Parent: Object

A collection that provides access to IAM server certificates belonging to this account.

  iam = AWS::IAM.new
  certificates = iam.server_certificates

Uploading A Server Certificate

You can upload any valid, signed certificate using {upload}.

  certificates.upload(:name => "MyCert",
                      :certificate_body => my_certificate_body,
                      :private_key => my_private_key)

For information about generating a server certificate for use with IAM, see {docs.amazonwebservices.com/IAM/latest/UserGuide/InstallCert.html Creating and Uploading Server Certificates} in Using AWS Identity and Access Management.

Getting a Server Certificate by Name

You can get a reference to a server certificate using array notation:

  certificate = certificates['MyCert']

Enumerating Server Certificates

Server certificate collections can also be used to enumerate certificates:

  certificates.each do |cert|
    puts cert.name
  end

You can limit the certificates returned by passing a +:prefix+ option to any of the enumerator methods. When you pass a prefix, only the certificates whose paths start with the given string will be returned.

Methods

[]   create   each_item   upload  

Included Modules

Collection::WithPrefix

Public Instance methods

Returns a reference to the server certificate with the given name:

  certificate = iam.server_certificates['MyCert']

@param [String] name Name of the server certificate.

@return [ServerCertificate] Returns a reference to the named

  server certificate.
create(options = {})

Alias for upload

Uploads a server certificate entity for the AWS account. The server certificate entity includes a public key certificate, a private key, and an optional certificate chain, which should all be PEM-encoded.

@param [Hash] options Options for uploading the certificate.

  +:name+, +:certificate_body+, and +:private_key+ are
  required.

@option options [String] :certificate_body The contents of the

  public key certificate in PEM-encoded format.

@option options [String] :name The name for the server

  certificate. Do not include the path in this value.

@option options [String] :path The path for the server

  certificate. For more information about paths, see
  {http://docs.amazonwebservices.com/IAM/latest/UserGuide/index.html?Using_Identifiers.html
  Identifiers for IAM Entities} in <i>Using AWS Identity and
  Access Management</i>.

@option options [String] :private_key The contents of the

  private key in PEM-encoded format.

@option options [String] :certificate_chain The contents of

  the certificate chain. This is typically a concatenation of
  the PEM-encoded public key certificates of the chain.

@return [ServerCertificate] The newly created server

  certificate.

Protected Instance methods

[Validate]