Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Akeyless Provider
  4. API Docs
  5. CertificateDiscovery
Viewing docs for akeyless 2.0.4
published on Monday, Aug 10, 2026 by akeyless-community
Schema (JSON)
akeyless-community/terraform-provider-akeyless

akeyless.CertificateDiscovery

Viewing docs for akeyless 2.0.4
published on Monday, Aug 10, 2026 by akeyless-community
Schema (JSON)
akeyless-community/terraform-provider-akeyless

    Create CertificateDiscovery Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new CertificateDiscovery(name: string, args: CertificateDiscoveryArgs, opts?: CustomResourceOptions);
    @overload
def CertificateDiscovery(resource_name: str,
                         args: CertificateDiscoveryArgs,
                         opts: Optional[ResourceOptions] = None)

@overload
def CertificateDiscovery(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         hosts: Optional[str] = None,
                         target_location: Optional[str] = None,
                         certificate_discovery_id: Optional[str] = None,
                         expiration_event_ins: Optional[Sequence[str]] = None,
                         port_ranges: Optional[str] = None,
                         protection_key: Optional[str] = None)
    func NewCertificateDiscovery(ctx *Context, name string, args CertificateDiscoveryArgs, opts ...ResourceOption) (*CertificateDiscovery, error)
    public CertificateDiscovery(string name, CertificateDiscoveryArgs args, CustomResourceOptions? opts = null)
    public CertificateDiscovery(String name, CertificateDiscoveryArgs args)
public CertificateDiscovery(String name, CertificateDiscoveryArgs args, CustomResourceOptions options)

    type: akeyless:CertificateDiscovery
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "akeyless_certificate_discovery" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args CertificateDiscoveryArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args CertificateDiscoveryArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args CertificateDiscoveryArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CertificateDiscoveryArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CertificateDiscoveryArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var certificateDiscoveryResource = new Akeyless.CertificateDiscovery("certificateDiscoveryResource", new()
{
    Hosts = "string",
    TargetLocation = "string",
    CertificateDiscoveryId = "string",
    ExpirationEventIns = new[]
    {
        "string",
    },
    PortRanges = "string",
    ProtectionKey = "string",
});

    example, err := akeyless.NewCertificateDiscovery(ctx, "certificateDiscoveryResource", &akeyless.CertificateDiscoveryArgs{
	Hosts:                  pulumi.String("string"),
	TargetLocation:         pulumi.String("string"),
	CertificateDiscoveryId: pulumi.String("string"),
	ExpirationEventIns: pulumi.StringArray{
		pulumi.String("string"),
	},
	PortRanges:    pulumi.String("string"),
	ProtectionKey: pulumi.String("string"),
})

    resource "akeyless_certificate_discovery" "certificateDiscoveryResource" {
  lifecycle {
    create_before_destroy = true
  }
  hosts                    = "string"
  target_location          = "string"
  certificate_discovery_id = "string"
  expiration_event_ins     = ["string"]
  port_ranges              = "string"
  protection_key           = "string"
}

    var certificateDiscoveryResource = new CertificateDiscovery("certificateDiscoveryResource", CertificateDiscoveryArgs.builder()
    .hosts("string")
    .targetLocation("string")
    .certificateDiscoveryId("string")
    .expirationEventIns("string")
    .portRanges("string")
    .protectionKey("string")
    .build());

    certificate_discovery_resource = akeyless.CertificateDiscovery("certificateDiscoveryResource",
    hosts="string",
    target_location="string",
    certificate_discovery_id="string",
    expiration_event_ins=["string"],
    port_ranges="string",
    protection_key="string")

    const certificateDiscoveryResource = new akeyless.CertificateDiscovery("certificateDiscoveryResource", {
    hosts: "string",
    targetLocation: "string",
    certificateDiscoveryId: "string",
    expirationEventIns: ["string"],
    portRanges: "string",
    protectionKey: "string",
});

    type: akeyless:CertificateDiscovery
properties:
    certificateDiscoveryId: string
    expirationEventIns:
        - string
    hosts: string
    portRanges: string
    protectionKey: string
    targetLocation: string

    CertificateDiscovery Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The CertificateDiscovery resource accepts the following input properties:

    Hosts string
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    TargetLocation string
    The results will be saved in this folder
    CertificateDiscoveryId string
    The ID of this resource.
    ExpirationEventIns List<string>
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    PortRanges string
    A comma separated list of port ranges. Example: 80,8080-8085
    ProtectionKey string
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    Hosts string
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    TargetLocation string
    The results will be saved in this folder
    CertificateDiscoveryId string
    The ID of this resource.
    ExpirationEventIns []string
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    PortRanges string
    A comma separated list of port ranges. Example: 80,8080-8085
    ProtectionKey string
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    hosts string
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    target_location string
    The results will be saved in this folder
    certificate_discovery_id string
    The ID of this resource.
    expiration_event_ins list(string)
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    port_ranges string
    A comma separated list of port ranges. Example: 80,8080-8085
    protection_key string
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    hosts String
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    targetLocation String
    The results will be saved in this folder
    certificateDiscoveryId String
    The ID of this resource.
    expirationEventIns List<String>
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    portRanges String
    A comma separated list of port ranges. Example: 80,8080-8085
    protectionKey String
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    hosts string
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    targetLocation string
    The results will be saved in this folder
    certificateDiscoveryId string
    The ID of this resource.
    expirationEventIns string[]
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    portRanges string
    A comma separated list of port ranges. Example: 80,8080-8085
    protectionKey string
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    hosts str
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    target_location str
    The results will be saved in this folder
    certificate_discovery_id str
    The ID of this resource.
    expiration_event_ins Sequence[str]
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    port_ranges str
    A comma separated list of port ranges. Example: 80,8080-8085
    protection_key str
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    hosts String
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    targetLocation String
    The results will be saved in this folder
    certificateDiscoveryId String
    The ID of this resource.
    expirationEventIns List<String>
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    portRanges String
    A comma separated list of port ranges. Example: 80,8080-8085
    protectionKey String
    The name of the key that protects the certificate value (if empty, the account default key will be used)

    Outputs

    All input properties are implicitly available as output properties. Additionally, the CertificateDiscovery resource produces the following output properties:

    CountExisting double
    Number of existing certificates updated
    CountFailed double
    Number of failed scan targets
    CountHosts double
    Number of hosts scanned
    CountNew double
    Number of new certificates discovered
    Id string
    The provider-assigned unique ID for this managed resource.
    ItemNames List<string>
    Names of certificate items created or updated by the discovery
    CountExisting float64
    Number of existing certificates updated
    CountFailed float64
    Number of failed scan targets
    CountHosts float64
    Number of hosts scanned
    CountNew float64
    Number of new certificates discovered
    Id string
    The provider-assigned unique ID for this managed resource.
    ItemNames []string
    Names of certificate items created or updated by the discovery
    count_existing number
    Number of existing certificates updated
    count_failed number
    Number of failed scan targets
    count_hosts number
    Number of hosts scanned
    count_new number
    Number of new certificates discovered
    id string
    The provider-assigned unique ID for this managed resource.
    item_names list(string)
    Names of certificate items created or updated by the discovery
    countExisting Double
    Number of existing certificates updated
    countFailed Double
    Number of failed scan targets
    countHosts Double
    Number of hosts scanned
    countNew Double
    Number of new certificates discovered
    id String
    The provider-assigned unique ID for this managed resource.
    itemNames List<String>
    Names of certificate items created or updated by the discovery
    countExisting number
    Number of existing certificates updated
    countFailed number
    Number of failed scan targets
    countHosts number
    Number of hosts scanned
    countNew number
    Number of new certificates discovered
    id string
    The provider-assigned unique ID for this managed resource.
    itemNames string[]
    Names of certificate items created or updated by the discovery
    count_existing float
    Number of existing certificates updated
    count_failed float
    Number of failed scan targets
    count_hosts float
    Number of hosts scanned
    count_new float
    Number of new certificates discovered
    id str
    The provider-assigned unique ID for this managed resource.
    item_names Sequence[str]
    Names of certificate items created or updated by the discovery
    countExisting Number
    Number of existing certificates updated
    countFailed Number
    Number of failed scan targets
    countHosts Number
    Number of hosts scanned
    countNew Number
    Number of new certificates discovered
    id String
    The provider-assigned unique ID for this managed resource.
    itemNames List<String>
    Names of certificate items created or updated by the discovery

    Look up Existing CertificateDiscovery Resource

    Get an existing CertificateDiscovery resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: CertificateDiscoveryState, opts?: CustomResourceOptions): CertificateDiscovery
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        certificate_discovery_id: Optional[str] = None,
        count_existing: Optional[float] = None,
        count_failed: Optional[float] = None,
        count_hosts: Optional[float] = None,
        count_new: Optional[float] = None,
        expiration_event_ins: Optional[Sequence[str]] = None,
        hosts: Optional[str] = None,
        item_names: Optional[Sequence[str]] = None,
        port_ranges: Optional[str] = None,
        protection_key: Optional[str] = None,
        target_location: Optional[str] = None) -> CertificateDiscovery
    func GetCertificateDiscovery(ctx *Context, name string, id IDInput, state *CertificateDiscoveryState, opts ...ResourceOption) (*CertificateDiscovery, error)
    public static CertificateDiscovery Get(string name, Input<string> id, CertificateDiscoveryState? state, CustomResourceOptions? opts = null)
    public static CertificateDiscovery get(String name, Output<String> id, CertificateDiscoveryState state, CustomResourceOptions options)
    resources:  _:    type: akeyless:CertificateDiscovery    get:      id: ${id}
    import {
  to = akeyless_certificate_discovery.example
  id = "${id}"
}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    CertificateDiscoveryId string
    The ID of this resource.
    CountExisting double
    Number of existing certificates updated
    CountFailed double
    Number of failed scan targets
    CountHosts double
    Number of hosts scanned
    CountNew double
    Number of new certificates discovered
    ExpirationEventIns List<string>
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    Hosts string
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    ItemNames List<string>
    Names of certificate items created or updated by the discovery
    PortRanges string
    A comma separated list of port ranges. Example: 80,8080-8085
    ProtectionKey string
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    TargetLocation string
    The results will be saved in this folder
    CertificateDiscoveryId string
    The ID of this resource.
    CountExisting float64
    Number of existing certificates updated
    CountFailed float64
    Number of failed scan targets
    CountHosts float64
    Number of hosts scanned
    CountNew float64
    Number of new certificates discovered
    ExpirationEventIns []string
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    Hosts string
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    ItemNames []string
    Names of certificate items created or updated by the discovery
    PortRanges string
    A comma separated list of port ranges. Example: 80,8080-8085
    ProtectionKey string
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    TargetLocation string
    The results will be saved in this folder
    certificate_discovery_id string
    The ID of this resource.
    count_existing number
    Number of existing certificates updated
    count_failed number
    Number of failed scan targets
    count_hosts number
    Number of hosts scanned
    count_new number
    Number of new certificates discovered
    expiration_event_ins list(string)
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    hosts string
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    item_names list(string)
    Names of certificate items created or updated by the discovery
    port_ranges string
    A comma separated list of port ranges. Example: 80,8080-8085
    protection_key string
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    target_location string
    The results will be saved in this folder
    certificateDiscoveryId String
    The ID of this resource.
    countExisting Double
    Number of existing certificates updated
    countFailed Double
    Number of failed scan targets
    countHosts Double
    Number of hosts scanned
    countNew Double
    Number of new certificates discovered
    expirationEventIns List<String>
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    hosts String
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    itemNames List<String>
    Names of certificate items created or updated by the discovery
    portRanges String
    A comma separated list of port ranges. Example: 80,8080-8085
    protectionKey String
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    targetLocation String
    The results will be saved in this folder
    certificateDiscoveryId string
    The ID of this resource.
    countExisting number
    Number of existing certificates updated
    countFailed number
    Number of failed scan targets
    countHosts number
    Number of hosts scanned
    countNew number
    Number of new certificates discovered
    expirationEventIns string[]
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    hosts string
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    itemNames string[]
    Names of certificate items created or updated by the discovery
    portRanges string
    A comma separated list of port ranges. Example: 80,8080-8085
    protectionKey string
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    targetLocation string
    The results will be saved in this folder
    certificate_discovery_id str
    The ID of this resource.
    count_existing float
    Number of existing certificates updated
    count_failed float
    Number of failed scan targets
    count_hosts float
    Number of hosts scanned
    count_new float
    Number of new certificates discovered
    expiration_event_ins Sequence[str]
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    hosts str
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    item_names Sequence[str]
    Names of certificate items created or updated by the discovery
    port_ranges str
    A comma separated list of port ranges. Example: 80,8080-8085
    protection_key str
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    target_location str
    The results will be saved in this folder
    certificateDiscoveryId String
    The ID of this resource.
    countExisting Number
    Number of existing certificates updated
    countFailed Number
    Number of failed scan targets
    countHosts Number
    Number of hosts scanned
    countNew Number
    Number of new certificates discovered
    expirationEventIns List<String>
    How many days before the expiration of the certificate would you like to be notified. To specify multiple events, repeat this argument.
    hosts String
    A comma separated list of IPs, CIDR ranges, or DNS names to scan
    itemNames List<String>
    Names of certificate items created or updated by the discovery
    portRanges String
    A comma separated list of port ranges. Example: 80,8080-8085
    protectionKey String
    The name of the key that protects the certificate value (if empty, the account default key will be used)
    targetLocation String
    The results will be saved in this folder

    Package Details

    Repository
    akeyless akeyless-community/terraform-provider-akeyless
    License
    Notes
    This Pulumi package is based on the akeyless Terraform Provider.
    Viewing docs for akeyless 2.0.4
    published on Monday, Aug 10, 2026 by akeyless-community
    Schema (JSON)
    akeyless-community/terraform-provider-akeyless

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial