You are viewing documentation for version 3 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: Aws::ACMPCA::Client

Inherits:
Seahorse::Client::Base show all
Includes:
ClientStubs
Defined in:
gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

#config, #handlers

API Operations collapse

Instance Method Summary collapse

Methods included from ClientStubs

#api_requests, #stub_data, #stub_responses

Methods inherited from Seahorse::Client::Base

add_plugin, api, clear_plugins, define, new, #operation_names, plugins, remove_plugin, set_api, set_plugins

Methods included from Seahorse::Client::HandlerBuilder

#handle, #handle_request, #handle_response

Constructor Details

#initialize(options) ⇒ Client

Returns a new instance of Client

Parameters:

  • options (Hash)

Options Hash (options):

  • :credentials (required, Aws::CredentialProvider)

    Your AWS credentials. This can be an instance of any one of the following classes:

    • Aws::Credentials - Used for configuring static, non-refreshing credentials.

    • Aws::InstanceProfileCredentials - Used for loading credentials from an EC2 IMDS on an EC2 instance.

    • Aws::SharedCredentials - Used for loading credentials from a shared file, such as ~/.aws/config.

    • Aws::AssumeRoleCredentials - Used when you need to assume a role.

    When :credentials are not configured directly, the following locations will be searched for credentials:

    • Aws.config[:credentials]
    • The :access_key_id, :secret_access_key, and :session_token options.
    • ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
    • ~/.aws/credentials
    • ~/.aws/config
    • EC2 IMDS instance profile - When used by default, the timeouts are very aggressive. Construct and pass an instance of Aws::InstanceProfileCredentails to enable retries and extended timeouts.
  • :region (required, String)

    The AWS region to connect to. The configured :region is used to determine the service :endpoint. When not passed, a default :region is search for in the following locations:

    • Aws.config[:region]
    • ENV['AWS_REGION']
    • ENV['AMAZON_REGION']
    • ENV['AWS_DEFAULT_REGION']
    • ~/.aws/credentials
    • ~/.aws/config
  • :access_key_id (String)
  • :active_endpoint_cache (Boolean) — default: false

    When set to true, a thread polling for endpoints will be running in the background every 60 secs (default). Defaults to false.

  • :client_side_monitoring (Boolean) — default: false

    When true, client-side metrics will be collected for all API requests from this client.

  • :client_side_monitoring_client_id (String) — default: ""

    Allows you to provide an identifier for this client which will be attached to all generated client side metrics. Defaults to an empty string.

  • :client_side_monitoring_port (Integer) — default: 31000

    Required for publishing client metrics. The port that the client side monitoring agent is running on, where client metrics will be published via UDP.

  • :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) — default: Aws::ClientSideMonitoring::Publisher

    Allows you to provide a custom client-side monitoring publisher class. By default, will use the Client Side Monitoring Agent Publisher.

  • :convert_params (Boolean) — default: true

    When true, an attempt is made to coerce request parameters into the required types.

  • :disable_host_prefix_injection (Boolean) — default: false

    Set to true to disable SDK automatically adding host prefix to default service endpoint when available.

  • :endpoint (String)

    The client endpoint is normally constructed from the :region option. You should only configure an :endpoint when connecting to test endpoints. This should be avalid HTTP(S) URI.

  • :endpoint_cache_max_entries (Integer) — default: 1000

    Used for the maximum size limit of the LRU cache storing endpoints data for endpoint discovery enabled operations. Defaults to 1000.

  • :endpoint_cache_max_threads (Integer) — default: 10

    Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.

  • :endpoint_cache_poll_interval (Integer) — default: 60

    When :endpoint_discovery and :active_endpoint_cache is enabled, Use this option to config the time interval in seconds for making requests fetching endpoints information. Defaults to 60 sec.

  • :endpoint_discovery (Boolean) — default: false

    When set to true, endpoint discovery will be enabled for operations when available. Defaults to false.

  • :log_formatter (Aws::Log::Formatter) — default: Aws::Log::Formatter.default

    The log formatter.

  • :log_level (Symbol) — default: :info

    The log level to send messages to the :logger at.

  • :logger (Logger)

    The Logger instance to send log messages to. If this option is not set, logging will be disabled.

  • :profile (String) — default: "default"

    Used when loading credentials from the shared credentials file at HOME/.aws/credentials. When not specified, 'default' is used.

  • :retry_base_delay (Float) — default: 0.3

    The base delay in seconds used by the default backoff function.

  • :retry_jitter (Symbol) — default: :none

    A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.

    @see https://www.awsarchitectureblog.com/2015/03/backoff.html

  • :retry_limit (Integer) — default: 3

    The maximum number of times to retry failed requests. Only ~ 500 level server errors and certain ~ 400 level client errors are retried. Generally, these are throttling errors, data checksum errors, networking errors, timeout errors and auth errors from expired credentials.

  • :retry_max_delay (Integer) — default: 0

    The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.

  • :secret_access_key (String)
  • :session_token (String)
  • :simple_json (Boolean) — default: false

    Disables request parameter conversion, validation, and formatting. Also disable response data type conversions. This option is useful when you want to ensure the highest level of performance by avoiding overhead of walking request parameters and response data structures.

    When :simple_json is enabled, the request parameters hash must be formatted exactly as the DynamoDB API expects.

  • :stub_responses (Boolean) — default: false

    Causes the client to return stubbed responses. By default fake responses are generated and returned. You can specify the response data to return or errors to raise by calling ClientStubs#stub_responses. See ClientStubs for more information.

    Please note When response stubbing is enabled, no HTTP requests are made, and retries are disabled.

  • :validate_params (Boolean) — default: true

    When true, request parameters are validated before sending the request.

  • :http_proxy (URI::HTTP, String)

    A proxy to send requests through. Formatted like 'http://proxy.com:123'.

  • :http_open_timeout (Float) — default: 15

    The number of seconds to wait when opening a HTTP session before rasing a Timeout::Error.

  • :http_read_timeout (Integer) — default: 60

    The default number of seconds to wait for response data. This value can safely be set per-request on the session yeidled by #session_for.

  • :http_idle_timeout (Float) — default: 5

    The number of seconds a connection is allowed to sit idble before it is considered stale. Stale connections are closed and removed from the pool before making a request.

  • :http_continue_timeout (Float) — default: 1

    The number of seconds to wait for a 100-continue response before sending the request body. This option has no effect unless the request has "Expect" header set to "100-continue". Defaults to nil which disables this behaviour. This value can safely be set per request on the session yeidled by #session_for.

  • :http_wire_trace (Boolean) — default: false

    When true, HTTP debug output will be sent to the :logger.

  • :ssl_verify_peer (Boolean) — default: true

    When true, SSL peer certificates are verified when establishing a connection.

  • :ssl_ca_bundle (String)

    Full path to the SSL certificate authority bundle file that should be used when verifying peer certificates. If you do not pass :ssl_ca_bundle or :ssl_ca_directory the the system default will be used if available.

  • :ssl_ca_directory (String)

    Full path of the directory that contains the unbundled SSL certificate authority files for verifying peer certificates. If you do not pass :ssl_ca_bundle or :ssl_ca_directory the the system default will be used if available.



255
256
257
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 255

def initialize(*args)
  super
end

Instance Method Details

#create_certificate_authority(params = {}) ⇒ Types::CreateCertificateAuthorityResponse

Creates a private subordinate certificate authority (CA). You must specify the CA configuration, the revocation configuration, the CA type, and an optional idempotency token. The CA configuration specifies the name of the algorithm and key size to be used to create the CA private key, the type of signing algorithm that the CA uses to sign, and X.500 subject information. The CRL (certificate revocation list) configuration specifies the CRL expiration period in days (the validity period of the CRL), the Amazon S3 bucket that will contain the CRL, and a CNAME alias for the S3 bucket that is included in certificates issued by the CA. If successful, this operation returns the Amazon Resource Name (ARN) of the CA.

Examples:

Request syntax with placeholder values


resp = client.create_certificate_authority({
  certificate_authority_configuration: { # required
    key_algorithm: "RSA_2048", # required, accepts RSA_2048, RSA_4096, EC_prime256v1, EC_secp384r1
    signing_algorithm: "SHA256WITHECDSA", # required, accepts SHA256WITHECDSA, SHA384WITHECDSA, SHA512WITHECDSA, SHA256WITHRSA, SHA384WITHRSA, SHA512WITHRSA
    subject: { # required
      country: "CountryCodeString",
      organization: "String64",
      organizational_unit: "String64",
      distinguished_name_qualifier: "DistinguishedNameQualifierString",
      state: "String128",
      common_name: "String64",
      serial_number: "String64",
      locality: "String128",
      title: "String64",
      surname: "String40",
      given_name: "String16",
      initials: "String5",
      pseudonym: "String128",
      generation_qualifier: "String3",
    },
  },
  revocation_configuration: {
    crl_configuration: {
      enabled: false, # required
      expiration_in_days: 1,
      custom_cname: "String253",
      s3_bucket_name: "String3To255",
    },
  },
  certificate_authority_type: "SUBORDINATE", # required, accepts SUBORDINATE
  idempotency_token: "IdempotencyToken",
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue",
    },
  ],
})

Response structure


resp.certificate_authority_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_configuration (required, Types::CertificateAuthorityConfiguration)

    Name and bit size of the private key algorithm, the name of the signing algorithm, and X.500 certificate subject information.

  • :revocation_configuration (Types::RevocationConfiguration)

    Contains a Boolean value that you can use to enable a certification revocation list (CRL) for the CA, the name of the S3 bucket to which ACM PCA will write the CRL, and an optional CNAME alias that you can use to hide the name of your bucket in the CRL Distribution Points extension of your CA certificate. For more information, see the CrlConfiguration structure.

  • :certificate_authority_type (required, String)

    The type of the certificate authority. Currently, this must be SUBORDINATE.

  • :idempotency_token (String)

    Alphanumeric string that can be used to distinguish between calls to CreateCertificateAuthority. Idempotency tokens time out after five minutes. Therefore, if you call CreateCertificateAuthority multiple times with the same idempotency token within a five minute period, ACM PCA recognizes that you are requesting only one certificate. As a result, ACM PCA issues only one. If you change the idempotency token for each call, however, ACM PCA recognizes that you are requesting multiple certificates.

  • :tags (Array<Types::Tag>)

    Key-value pairs that will be attached to the new private CA. You can associate up to 50 tags with a private CA.

Returns:

See Also:



356
357
358
359
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 356

def create_certificate_authority(params = {}, options = {})
  req = build_request(:create_certificate_authority, params)
  req.send_request(options)
end

#create_certificate_authority_audit_report(params = {}) ⇒ Types::CreateCertificateAuthorityAuditReportResponse

Creates an audit report that lists every time that your CA private key is used. The report is saved in the Amazon S3 bucket that you specify on input. The IssueCertificate and RevokeCertificate operations use the private key. You can generate a new report every 30 minutes.

Examples:

Request syntax with placeholder values


resp = client.create_certificate_authority_audit_report({
  certificate_authority_arn: "Arn", # required
  s3_bucket_name: "String", # required
  audit_report_response_format: "JSON", # required, accepts JSON, CSV
})

Response structure


resp.audit_report_id #=> String
resp.s3_key #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) of the CA to be audited. This is of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

  • :s3_bucket_name (required, String)

    The name of the S3 bucket that will contain the audit report.

  • :audit_report_response_format (required, String)

    The format in which to create the report. This can be either JSON or CSV.

Returns:

See Also:



402
403
404
405
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 402

def create_certificate_authority_audit_report(params = {}, options = {})
  req = build_request(:create_certificate_authority_audit_report, params)
  req.send_request(options)
end

#create_permission(params = {}) ⇒ Struct

Assigns permissions from a private CA to a designated AWS service. Services are specified by their service principals and can be given permission to create and retrieve certificates on a private CA. Services can also be given permission to list the active permissions that the private CA has granted. For ACM to automatically renew your private CA's certificates, you must assign all possible permissions from the CA to the ACM service principal.

At this time, you can only assign permissions to ACM (acm.amazonaws.com). Permissions can be revoked with the DeletePermission operation and listed with the ListPermissions operation.

Examples:

Request syntax with placeholder values


resp = client.create_permission({
  certificate_authority_arn: "Arn", # required
  principal: "Principal", # required
  source_account: "AccountId",
  actions: ["IssueCertificate"], # required, accepts IssueCertificate, GetCertificate, ListPermissions
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) of the CA that grants the permissions. You can find the ARN by calling the ListCertificateAuthorities operation. This must have the following form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

  • :principal (required, String)

    The AWS service or identity that receives the permission. At this time, the only valid principal is acm.amazonaws.com.

  • :source_account (String)

    The ID of the calling account.

  • :actions (required, Array<String>)

    The actions that the specified AWS service principal can use. These include IssueCertificate, GetCertificate, and ListPermissions.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



454
455
456
457
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 454

def create_permission(params = {}, options = {})
  req = build_request(:create_permission, params)
  req.send_request(options)
end

#delete_certificate_authority(params = {}) ⇒ Struct

Deletes a private certificate authority (CA). You must provide the ARN (Amazon Resource Name) of the private CA that you want to delete. You can find the ARN by calling the ListCertificateAuthorities operation. Before you can delete a CA, you must disable it. Call the UpdateCertificateAuthority operation and set the CertificateAuthorityStatus parameter to DISABLED.

Additionally, you can delete a CA if you are waiting for it to be created (the Status field of the CertificateAuthority is CREATING). You can also delete it if the CA has been created but you haven't yet imported the signed certificate (the Status is PENDING_CERTIFICATE) into ACM PCA.

If the CA is in one of the previously mentioned states and you call DeleteCertificateAuthority, the CA's status changes to DELETED. However, the CA won't be permanently deleted until the restoration period has passed. By default, if you do not set the PermanentDeletionTimeInDays parameter, the CA remains restorable for 30 days. You can set the parameter from 7 to 30 days. The DescribeCertificateAuthority operation returns the time remaining in the restoration window of a Private CA in the DELETED state. To restore an eligible CA, call the RestoreCertificateAuthority operation.

Examples:

Request syntax with placeholder values


resp = client.delete_certificate_authority({
  certificate_authority_arn: "Arn", # required
  permanent_deletion_time_in_days: 1,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must have the following form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

  • :permanent_deletion_time_in_days (Integer)

    The number of days to make a CA restorable after it has been deleted. This can be anywhere from 7 to 30 days, with 30 being the default.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



507
508
509
510
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 507

def delete_certificate_authority(params = {}, options = {})
  req = build_request(:delete_certificate_authority, params)
  req.send_request(options)
end

#delete_permission(params = {}) ⇒ Struct

Revokes permissions that a private CA assigned to a designated AWS service. Permissions can be created with the CreatePermission operation and listed with the ListPermissions operation.

Examples:

Request syntax with placeholder values


resp = client.delete_permission({
  certificate_authority_arn: "Arn", # required
  principal: "Principal", # required
  source_account: "AccountId",
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Number (ARN) of the private CA that issued the permissions. You can find the CA's ARN by calling the ListCertificateAuthorities operation. This must have the following form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

  • :principal (required, String)

    The AWS service or identity that will have its CA permissions revoked. At this time, the only valid service principal is acm.amazonaws.com

  • :source_account (String)

    The AWS account that calls this operation.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



546
547
548
549
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 546

def delete_permission(params = {}, options = {})
  req = build_request(:delete_permission, params)
  req.send_request(options)
end

#describe_certificate_authority(params = {}) ⇒ Types::DescribeCertificateAuthorityResponse

Lists information about your private certificate authority (CA). You specify the private CA on input by its ARN (Amazon Resource Name). The output contains the status of your CA. This can be any of the following:

  • CREATING - ACM PCA is creating your private certificate authority.

  • PENDING_CERTIFICATE - The certificate is pending. You must use your on-premises root or subordinate CA to sign your private CA CSR and then import it into PCA.

  • ACTIVE - Your private CA is active.

  • DISABLED - Your private CA has been disabled.

  • EXPIRED - Your private CA certificate has expired.

  • FAILED - Your private CA has failed. Your CA can fail because of problems such a network outage or backend AWS failure or other errors. A failed CA can never return to the pending state. You must create a new CA.

  • DELETED - Your private CA is within the restoration period, after which it is permanently deleted. The length of time remaining in the CA's restoration period is also included in this operation's output.

Examples:

Request syntax with placeholder values


resp = client.describe_certificate_authority({
  certificate_authority_arn: "Arn", # required
})

Response structure


resp.certificate_authority.arn #=> String
resp.certificate_authority.created_at #=> Time
resp.certificate_authority.last_state_change_at #=> Time
resp.certificate_authority.type #=> String, one of "SUBORDINATE"
resp.certificate_authority.serial #=> String
resp.certificate_authority.status #=> String, one of "CREATING", "PENDING_CERTIFICATE", "ACTIVE", "DELETED", "DISABLED", "EXPIRED", "FAILED"
resp.certificate_authority.not_before #=> Time
resp.certificate_authority.not_after #=> Time
resp.certificate_authority.failure_reason #=> String, one of "REQUEST_TIMED_OUT", "UNSUPPORTED_ALGORITHM", "OTHER"
resp.certificate_authority.certificate_authority_configuration.key_algorithm #=> String, one of "RSA_2048", "RSA_4096", "EC_prime256v1", "EC_secp384r1"
resp.certificate_authority.certificate_authority_configuration.signing_algorithm #=> String, one of "SHA256WITHECDSA", "SHA384WITHECDSA", "SHA512WITHECDSA", "SHA256WITHRSA", "SHA384WITHRSA", "SHA512WITHRSA"
resp.certificate_authority.certificate_authority_configuration.subject.country #=> String
resp.certificate_authority.certificate_authority_configuration.subject.organization #=> String
resp.certificate_authority.certificate_authority_configuration.subject.organizational_unit #=> String
resp.certificate_authority.certificate_authority_configuration.subject.distinguished_name_qualifier #=> String
resp.certificate_authority.certificate_authority_configuration.subject.state #=> String
resp.certificate_authority.certificate_authority_configuration.subject.common_name #=> String
resp.certificate_authority.certificate_authority_configuration.subject.serial_number #=> String
resp.certificate_authority.certificate_authority_configuration.subject.locality #=> String
resp.certificate_authority.certificate_authority_configuration.subject.title #=> String
resp.certificate_authority.certificate_authority_configuration.subject.surname #=> String
resp.certificate_authority.certificate_authority_configuration.subject.given_name #=> String
resp.certificate_authority.certificate_authority_configuration.subject.initials #=> String
resp.certificate_authority.certificate_authority_configuration.subject.pseudonym #=> String
resp.certificate_authority.certificate_authority_configuration.subject.generation_qualifier #=> String
resp.certificate_authority.revocation_configuration.crl_configuration.enabled #=> Boolean
resp.certificate_authority.revocation_configuration.crl_configuration.expiration_in_days #=> Integer
resp.certificate_authority.revocation_configuration.crl_configuration.custom_cname #=> String
resp.certificate_authority.revocation_configuration.crl_configuration.s3_bucket_name #=> String
resp.certificate_authority.restorable_until #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

Returns:

See Also:



632
633
634
635
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 632

def describe_certificate_authority(params = {}, options = {})
  req = build_request(:describe_certificate_authority, params)
  req.send_request(options)
end

#describe_certificate_authority_audit_report(params = {}) ⇒ Types::DescribeCertificateAuthorityAuditReportResponse

Lists information about a specific audit report created by calling the CreateCertificateAuthorityAuditReport operation. Audit information is created every time the certificate authority (CA) private key is used. The private key is used when you call the IssueCertificate operation or the RevokeCertificate operation.

Examples:

Request syntax with placeholder values


resp = client.describe_certificate_authority_audit_report({
  certificate_authority_arn: "Arn", # required
  audit_report_id: "AuditReportId", # required
})

Response structure


resp.audit_report_status #=> String, one of "CREATING", "SUCCESS", "FAILED"
resp.s3_bucket_name #=> String
resp.s3_key #=> String
resp.created_at #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) of the private CA. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

  • :audit_report_id (required, String)

    The report ID returned by calling the CreateCertificateAuthorityAuditReport operation.

Returns:

See Also:



679
680
681
682
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 679

def describe_certificate_authority_audit_report(params = {}, options = {})
  req = build_request(:describe_certificate_authority_audit_report, params)
  req.send_request(options)
end

#get_certificate(params = {}) ⇒ Types::GetCertificateResponse

Retrieves a certificate from your private CA. The ARN of the certificate is returned when you call the IssueCertificate operation. You must specify both the ARN of your private CA and the ARN of the issued certificate when calling the GetCertificate operation. You can retrieve the certificate if it is in the ISSUED state. You can call the CreateCertificateAuthorityAuditReport operation to create a report that contains information about all of the certificates issued and revoked by your private CA.

Examples:

Request syntax with placeholder values


resp = client.get_certificate({
  certificate_authority_arn: "Arn", # required
  certificate_arn: "Arn", # required
})

Response structure


resp.certificate #=> String
resp.certificate_chain #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

  • :certificate_arn (required, String)

    The ARN of the issued certificate. The ARN contains the certificate serial number and must be in the following form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012/certificate/286535153982981100925020015808220737245

Returns:

See Also:



728
729
730
731
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 728

def get_certificate(params = {}, options = {})
  req = build_request(:get_certificate, params)
  req.send_request(options)
end

#get_certificate_authority_certificate(params = {}) ⇒ Types::GetCertificateAuthorityCertificateResponse

Retrieves the certificate and certificate chain for your private certificate authority (CA). Both the certificate and the chain are base64 PEM-encoded. The chain does not include the CA certificate. Each certificate in the chain signs the one before it.

Examples:

Request syntax with placeholder values


resp = client.get_certificate_authority_certificate({
  certificate_authority_arn: "Arn", # required
})

Response structure


resp.certificate #=> String
resp.certificate_chain #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) of your private CA. This is of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 .

Returns:

See Also:



765
766
767
768
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 765

def get_certificate_authority_certificate(params = {}, options = {})
  req = build_request(:get_certificate_authority_certificate, params)
  req.send_request(options)
end

#get_certificate_authority_csr(params = {}) ⇒ Types::GetCertificateAuthorityCsrResponse

Retrieves the certificate signing request (CSR) for your private certificate authority (CA). The CSR is created when you call the CreateCertificateAuthority operation. Take the CSR to your on-premises X.509 infrastructure and sign it by using your root or a subordinate CA. Then import the signed certificate back into ACM PCA by calling the ImportCertificateAuthorityCertificate operation. The CSR is returned as a base64 PEM-encoded string.

Examples:

Request syntax with placeholder values


resp = client.get_certificate_authority_csr({
  certificate_authority_arn: "Arn", # required
})

Response structure


resp.csr #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority operation. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

Returns:

See Also:



803
804
805
806
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 803

def get_certificate_authority_csr(params = {}, options = {})
  req = build_request(:get_certificate_authority_csr, params)
  req.send_request(options)
end

#import_certificate_authority_certificate(params = {}) ⇒ Struct

Imports your signed private CA certificate into ACM PCA. Before you can call this operation, you must create the private certificate authority by calling the CreateCertificateAuthority operation. You must then generate a certificate signing request (CSR) by calling the GetCertificateAuthorityCsr operation. Take the CSR to your on-premises CA and use the root certificate or a subordinate certificate to sign it. Create a certificate chain and copy the signed certificate and the certificate chain to your working directory.

Your certificate chain must not include the private CA certificate that you are importing.

Your on-premises CA certificate must be the last certificate in your chain. The subordinate certificate, if any, that your root CA signed must be next to last. The subordinate certificate signed by the preceding subordinate CA must come next, and so on until your chain is built.

The chain must be PEM-encoded.

Examples:

Request syntax with placeholder values


resp = client.import_certificate_authority_certificate({
  certificate_authority_arn: "Arn", # required
  certificate: "data", # required
  certificate_chain: "data", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

  • :certificate (required, String, IO)

    The PEM-encoded certificate for your private CA. This must be signed by using your on-premises CA.

  • :certificate_chain (required, String, IO)

    A PEM-encoded file that contains all of your certificates, other than the certificate you're importing, chaining up to your root CA. Your on-premises root certificate is the last in the chain, and each certificate in the chain signs the one preceding.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



865
866
867
868
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 865

def import_certificate_authority_certificate(params = {}, options = {})
  req = build_request(:import_certificate_authority_certificate, params)
  req.send_request(options)
end

#issue_certificate(params = {}) ⇒ Types::IssueCertificateResponse

Uses your private certificate authority (CA) to issue a client certificate. This operation returns the Amazon Resource Name (ARN) of the certificate. You can retrieve the certificate by calling the GetCertificate operation and specifying the ARN.

You cannot use the ACM ListCertificateAuthorities operation to retrieve the ARNs of the certificates that you issue by using ACM PCA.

Examples:

Request syntax with placeholder values


resp = client.issue_certificate({
  certificate_authority_arn: "Arn", # required
  csr: "data", # required
  signing_algorithm: "SHA256WITHECDSA", # required, accepts SHA256WITHECDSA, SHA384WITHECDSA, SHA512WITHECDSA, SHA256WITHRSA, SHA384WITHRSA, SHA512WITHRSA
  validity: { # required
    value: 1, # required
    type: "END_DATE", # required, accepts END_DATE, ABSOLUTE, DAYS, MONTHS, YEARS
  },
  idempotency_token: "IdempotencyToken",
})

Response structure


resp.certificate_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

  • :csr (required, String, IO)

    The certificate signing request (CSR) for the certificate you want to issue. You can use the following OpenSSL command to create the CSR and a 2048 bit RSA private key.

    openssl req -new -newkey rsa:2048 -days 365 -keyout private/test_cert_priv_key.pem -out csr/test_cert_.csr

    If you have a configuration file, you can use the following OpenSSL command. The usr_cert block in the configuration file contains your X509 version 3 extensions.

    openssl req -new -config openssl_rsa.cnf -extensions usr_cert -newkey rsa:2048 -days -365 -keyout private/test_cert_priv_key.pem -out csr/test_cert_.csr

  • :signing_algorithm (required, String)

    The name of the algorithm that will be used to sign the certificate to be issued.

  • :validity (required, Types::Validity)

    The type of the validity period.

  • :idempotency_token (String)

    Custom string that can be used to distinguish between calls to the IssueCertificate operation. Idempotency tokens time out after one hour. Therefore, if you call IssueCertificate multiple times with the same idempotency token within 5 minutes, ACM PCA recognizes that you are requesting only one certificate and will issue only one. If you change the idempotency token for each call, PCA recognizes that you are requesting multiple certificates.

Returns:

See Also:



944
945
946
947
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 944

def issue_certificate(params = {}, options = {})
  req = build_request(:issue_certificate, params)
  req.send_request(options)
end

#list_certificate_authorities(params = {}) ⇒ Types::ListCertificateAuthoritiesResponse

Lists the private certificate authorities that you created by using the CreateCertificateAuthority operation.

Examples:

Request syntax with placeholder values


resp = client.list_certificate_authorities({
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.certificate_authorities #=> Array
resp.certificate_authorities[0].arn #=> String
resp.certificate_authorities[0].created_at #=> Time
resp.certificate_authorities[0].last_state_change_at #=> Time
resp.certificate_authorities[0].type #=> String, one of "SUBORDINATE"
resp.certificate_authorities[0].serial #=> String
resp.certificate_authorities[0].status #=> String, one of "CREATING", "PENDING_CERTIFICATE", "ACTIVE", "DELETED", "DISABLED", "EXPIRED", "FAILED"
resp.certificate_authorities[0].not_before #=> Time
resp.certificate_authorities[0].not_after #=> Time
resp.certificate_authorities[0].failure_reason #=> String, one of "REQUEST_TIMED_OUT", "UNSUPPORTED_ALGORITHM", "OTHER"
resp.certificate_authorities[0].certificate_authority_configuration.key_algorithm #=> String, one of "RSA_2048", "RSA_4096", "EC_prime256v1", "EC_secp384r1"
resp.certificate_authorities[0].certificate_authority_configuration.signing_algorithm #=> String, one of "SHA256WITHECDSA", "SHA384WITHECDSA", "SHA512WITHECDSA", "SHA256WITHRSA", "SHA384WITHRSA", "SHA512WITHRSA"
resp.certificate_authorities[0].certificate_authority_configuration.subject.country #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.organization #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.organizational_unit #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.distinguished_name_qualifier #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.state #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.common_name #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.serial_number #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.locality #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.title #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.surname #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.given_name #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.initials #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.pseudonym #=> String
resp.certificate_authorities[0].certificate_authority_configuration.subject.generation_qualifier #=> String
resp.certificate_authorities[0].revocation_configuration.crl_configuration.enabled #=> Boolean
resp.certificate_authorities[0].revocation_configuration.crl_configuration.expiration_in_days #=> Integer
resp.certificate_authorities[0].revocation_configuration.crl_configuration.custom_cname #=> String
resp.certificate_authorities[0].revocation_configuration.crl_configuration.s3_bucket_name #=> String
resp.certificate_authorities[0].restorable_until #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    Use this parameter when paginating results in a subsequent request after you receive a response with truncated results. Set it to the value of the NextToken parameter from the response you just received.

  • :max_results (Integer)

    Use this parameter when paginating results to specify the maximum number of items to return in the response on each page. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

Returns:

See Also:



1016
1017
1018
1019
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1016

def list_certificate_authorities(params = {}, options = {})
  req = build_request(:list_certificate_authorities, params)
  req.send_request(options)
end

#list_permissions(params = {}) ⇒ Types::ListPermissionsResponse

Lists all the permissions, if any, that have been assigned by a private CA. Permissions can be granted with the CreatePermission operation and revoked with the DeletePermission operation.

Examples:

Request syntax with placeholder values


resp = client.list_permissions({
  certificate_authority_arn: "Arn", # required
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.permissions #=> Array
resp.permissions[0].certificate_authority_arn #=> String
resp.permissions[0].created_at #=> Time
resp.permissions[0].principal #=> String
resp.permissions[0]. #=> String
resp.permissions[0].actions #=> Array
resp.permissions[0].actions[0] #=> String, one of "IssueCertificate", "GetCertificate", "ListPermissions"
resp.permissions[0].policy #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Number (ARN) of the private CA to inspect. You can find the ARN by calling the ListCertificateAuthorities operation. This must be of the form: arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 You can get a private CA's ARN by running the ListCertificateAuthorities operation.

  • :next_token (String)

    When paginating results, use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.

  • :max_results (Integer)

    When paginating results, use this parameter to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

Returns:

See Also:



1074
1075
1076
1077
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1074

def list_permissions(params = {}, options = {})
  req = build_request(:list_permissions, params)
  req.send_request(options)
end

#list_tags(params = {}) ⇒ Types::ListTagsResponse

Lists the tags, if any, that are associated with your private CA. Tags are labels that you can use to identify and organize your CAs. Each tag consists of a key and an optional value. Call the TagCertificateAuthority operation to add one or more tags to your CA. Call the UntagCertificateAuthority operation to remove tags.

Examples:

Request syntax with placeholder values


resp = client.list_tags({
  certificate_authority_arn: "Arn", # required
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority operation. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

  • :next_token (String)

    Use this parameter when paginating results in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.

  • :max_results (Integer)

    Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

Returns:

See Also:



1128
1129
1130
1131
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1128

def list_tags(params = {}, options = {})
  req = build_request(:list_tags, params)
  req.send_request(options)
end

#restore_certificate_authority(params = {}) ⇒ Struct

Restores a certificate authority (CA) that is in the DELETED state. You can restore a CA during the period that you defined in the PermanentDeletionTimeInDays parameter of the DeleteCertificateAuthority operation. Currently, you can specify 7 to 30 days. If you did not specify a PermanentDeletionTimeInDays value, by default you can restore the CA at any time in a 30 day period. You can check the time remaining in the restoration period of a private CA in the DELETED state by calling the DescribeCertificateAuthority or ListCertificateAuthorities operations. The status of a restored CA is set to its pre-deletion status when the RestoreCertificateAuthority operation returns. To change its status to ACTIVE, call the UpdateCertificateAuthority operation. If the private CA was in the PENDING_CERTIFICATE state at deletion, you must use the ImportCertificateAuthorityCertificate operation to import a certificate authority into the private CA before it can be activated. You cannot restore a CA after the restoration period has ended.

Examples:

Request syntax with placeholder values


resp = client.restore_certificate_authority({
  certificate_authority_arn: "Arn", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called the CreateCertificateAuthority operation. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1170
1171
1172
1173
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1170

def restore_certificate_authority(params = {}, options = {})
  req = build_request(:restore_certificate_authority, params)
  req.send_request(options)
end

#revoke_certificate(params = {}) ⇒ Struct

Revokes a certificate that you issued by calling the IssueCertificate operation. If you enable a certificate revocation list (CRL) when you create or update your private CA, information about the revoked certificates will be included in the CRL. ACM PCA writes the CRL to an S3 bucket that you specify. For more information about revocation, see the CrlConfiguration structure. ACM PCA also writes revocation information to the audit report. For more information, see CreateCertificateAuthorityAuditReport.

Examples:

Request syntax with placeholder values


resp = client.revoke_certificate({
  certificate_authority_arn: "Arn", # required
  certificate_serial: "String128", # required
  revocation_reason: "UNSPECIFIED", # required, accepts UNSPECIFIED, KEY_COMPROMISE, CERTIFICATE_AUTHORITY_COMPROMISE, AFFILIATION_CHANGED, SUPERSEDED, CESSATION_OF_OPERATION, PRIVILEGE_WITHDRAWN, A_A_COMPROMISE
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    Amazon Resource Name (ARN) of the private CA that issued the certificate to be revoked. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

  • :certificate_serial (required, String)

    Serial number of the certificate to be revoked. This must be in hexadecimal format. You can retrieve the serial number by calling GetCertificate with the Amazon Resource Name (ARN) of the certificate you want and the ARN of your private CA. The GetCertificate operation retrieves the certificate in the PEM format. You can use the following OpenSSL command to list the certificate in text format and copy the hexadecimal serial number.

    openssl x509 -in file_path -text -noout

    You can also copy the serial number from the console or use the DescribeCertificate operation in the AWS Certificate Manager API Reference.

  • :revocation_reason (required, String)

    Specifies why you revoked the certificate.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1227
1228
1229
1230
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1227

def revoke_certificate(params = {}, options = {})
  req = build_request(:revoke_certificate, params)
  req.send_request(options)
end

#tag_certificate_authority(params = {}) ⇒ Struct

Adds one or more tags to your private CA. Tags are labels that you can use to identify and organize your AWS resources. Each tag consists of a key and an optional value. You specify the private CA on input by its Amazon Resource Name (ARN). You specify the tag by using a key-value pair. You can apply a tag to just one private CA if you want to identify a specific characteristic of that CA, or you can apply the same tag to multiple private CAs if you want to filter for a common relationship among those CAs. To remove one or more tags, use the UntagCertificateAuthority operation. Call the ListTags operation to see what tags are associated with your CA.

Examples:

Request syntax with placeholder values


resp = client.tag_certificate_authority({
  certificate_authority_arn: "Arn", # required
  tags: [ # required
    {
      key: "TagKey", # required
      value: "TagValue",
    },
  ],
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

  • :tags (required, Array<Types::Tag>)

    List of tags to be associated with the CA.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1271
1272
1273
1274
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1271

def tag_certificate_authority(params = {}, options = {})
  req = build_request(:tag_certificate_authority, params)
  req.send_request(options)
end

#untag_certificate_authority(params = {}) ⇒ Struct

Remove one or more tags from your private CA. A tag consists of a key-value pair. If you do not specify the value portion of the tag when calling this operation, the tag will be removed regardless of value. If you specify a value, the tag is removed only if it is associated with the specified value. To add tags to a private CA, use the TagCertificateAuthority. Call the ListTags operation to see what tags are associated with your CA.

Examples:

Request syntax with placeholder values


resp = client.untag_certificate_authority({
  certificate_authority_arn: "Arn", # required
  tags: [ # required
    {
      key: "TagKey", # required
      value: "TagValue",
    },
  ],
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    The Amazon Resource Name (ARN) that was returned when you called CreateCertificateAuthority. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

  • :tags (required, Array<Types::Tag>)

    List of tags to be removed from the CA.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1312
1313
1314
1315
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1312

def untag_certificate_authority(params = {}, options = {})
  req = build_request(:untag_certificate_authority, params)
  req.send_request(options)
end

#update_certificate_authority(params = {}) ⇒ Struct

Updates the status or configuration of a private certificate authority (CA). Your private CA must be in the ACTIVE or DISABLED state before you can update it. You can disable a private CA that is in the ACTIVE state or make a CA that is in the DISABLED state active again.

Examples:

Request syntax with placeholder values


resp = client.update_certificate_authority({
  certificate_authority_arn: "Arn", # required
  revocation_configuration: {
    crl_configuration: {
      enabled: false, # required
      expiration_in_days: 1,
      custom_cname: "String253",
      s3_bucket_name: "String3To255",
    },
  },
  status: "CREATING", # accepts CREATING, PENDING_CERTIFICATE, ACTIVE, DELETED, DISABLED, EXPIRED, FAILED
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :certificate_authority_arn (required, String)

    Amazon Resource Name (ARN) of the private CA that issued the certificate to be revoked. This must be of the form:

    arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012

  • :revocation_configuration (Types::RevocationConfiguration)

    Revocation information for your private CA.

  • :status (String)

    Status of your private CA.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1357
1358
1359
1360
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1357

def update_certificate_authority(params = {}, options = {})
  req = build_request(:update_certificate_authority, params)
  req.send_request(options)
end

#wait_until(waiter_name, params = {}, options = {}) {|w.waiter| ... } ⇒ Boolean

Polls an API operation until a resource enters a desired state.

Basic Usage

A waiter will call an API operation until:

  • It is successful
  • It enters a terminal state
  • It makes the maximum number of attempts

In between attempts, the waiter will sleep.

# polls in a loop, sleeping between attempts
client.wait_until(waiter_name, params)

Configuration

You can configure the maximum number of polling attempts, and the delay (in seconds) between each polling attempt. You can pass configuration as the final arguments hash.

# poll for ~25 seconds
client.wait_until(waiter_name, params, {
  max_attempts: 5,
  delay: 5,
})

Callbacks

You can be notified before each polling attempt and before each delay. If you throw :success or :failure from these callbacks, it will terminate the waiter.

started_at = Time.now
client.wait_until(waiter_name, params, {

  # disable max attempts
  max_attempts: nil,

  # poll for 1 hour, instead of a number of attempts
  before_wait: -> (attempts, response) do
    throw :failure if Time.now - started_at > 3600
  end
})

Handling Errors

When a waiter is unsuccessful, it will raise an error. All of the failure errors extend from Waiters::Errors::WaiterFailed.

begin
  client.wait_until(...)
rescue Aws::Waiters::Errors::WaiterFailed
  # resource did not enter the desired state in time
end

Valid Waiters

The following table lists the valid waiter names, the operations they call, and the default :delay and :max_attempts values.

waiter_name params :delay :max_attempts
audit_report_created #describe_certificate_authority_audit_report 3 60
certificate_authority_csr_created #get_certificate_authority_csr 3 60
certificate_issued #get_certificate 3 60

Parameters:

  • waiter_name (Symbol)
  • params (Hash) (defaults to: {})

    ({})

  • options (Hash) (defaults to: {})

    ({})

Options Hash (options):

  • :max_attempts (Integer)
  • :delay (Integer)
  • :before_attempt (Proc)
  • :before_wait (Proc)

Yields:

  • (w.waiter)

Returns:

  • (Boolean)

    Returns true if the waiter was successful.

Raises:

  • (Errors::FailureStateError)

    Raised when the waiter terminates because the waiter has entered a state that it will not transition out of, preventing success.

  • (Errors::TooManyAttemptsError)

    Raised when the configured maximum number of attempts have been made, and the waiter is not yet successful.

  • (Errors::UnexpectedError)

    Raised when an error is encounted while polling for a resource that is not expected.

  • (Errors::NoSuchWaiterError)

    Raised when you request to wait for an unknown state.



1469
1470
1471
1472
1473
# File 'gems/aws-sdk-acmpca/lib/aws-sdk-acmpca/client.rb', line 1469

def wait_until(waiter_name, params = {}, options = {})
  w = waiter(waiter_name, options)
  yield(w.waiter) if block_given? # deprecated
  w.wait(params)
end