ibm 1.78.0, Apr 30 25

ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

ibm.CisCertificateUpload

Explore with Pulumi AI

ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

Provides an IBM Cloud Internet Services certificate upload resource. This resource is associated with an IBM Cloud Internet Services instance and a CIS domain resource. It allows to upload, update, and delete certificates of a domain of a CIS instance. For more information about CIS certificate upload, see Installing an origin certificate on your server.

Create CisCertificateUpload Resource

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

Constructor syntax

new CisCertificateUpload(name: string, args: CisCertificateUploadArgs, opts?: CustomResourceOptions);

@overload
def CisCertificateUpload(resource_name: str,
                         args: CisCertificateUploadArgs,
                         opts: Optional[ResourceOptions] = None)

@overload
def CisCertificateUpload(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         certificate: Optional[str] = None,
                         cis_id: Optional[str] = None,
                         domain_id: Optional[str] = None,
                         private_key: Optional[str] = None,
                         bundle_method: Optional[str] = None,
                         cis_certificate_upload_id: Optional[str] = None,
                         priority: Optional[float] = None)

func NewCisCertificateUpload(ctx *Context, name string, args CisCertificateUploadArgs, opts ...ResourceOption) (*CisCertificateUpload, error)

public CisCertificateUpload(string name, CisCertificateUploadArgs args, CustomResourceOptions? opts = null)

public CisCertificateUpload(String name, CisCertificateUploadArgs args)
public CisCertificateUpload(String name, CisCertificateUploadArgs args, CustomResourceOptions options)

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

Parameters

name string: The unique name of the resource.
args CisCertificateUploadArgs: 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 CisCertificateUploadArgs: 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 CisCertificateUploadArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args CisCertificateUploadArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args CisCertificateUploadArgs: 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 cisCertificateUploadResource = new Ibm.CisCertificateUpload("cisCertificateUploadResource", new()
{
    Certificate = "string",
    CisId = "string",
    DomainId = "string",
    PrivateKey = "string",
    BundleMethod = "string",
    CisCertificateUploadId = "string",
    Priority = 0,
});

example, err := ibm.NewCisCertificateUpload(ctx, "cisCertificateUploadResource", &ibm.CisCertificateUploadArgs{
	Certificate:            pulumi.String("string"),
	CisId:                  pulumi.String("string"),
	DomainId:               pulumi.String("string"),
	PrivateKey:             pulumi.String("string"),
	BundleMethod:           pulumi.String("string"),
	CisCertificateUploadId: pulumi.String("string"),
	Priority:               pulumi.Float64(0),
})

var cisCertificateUploadResource = new CisCertificateUpload("cisCertificateUploadResource", CisCertificateUploadArgs.builder()
    .certificate("string")
    .cisId("string")
    .domainId("string")
    .privateKey("string")
    .bundleMethod("string")
    .cisCertificateUploadId("string")
    .priority(0)
    .build());

cis_certificate_upload_resource = ibm.CisCertificateUpload("cisCertificateUploadResource",
    certificate="string",
    cis_id="string",
    domain_id="string",
    private_key="string",
    bundle_method="string",
    cis_certificate_upload_id="string",
    priority=0)

const cisCertificateUploadResource = new ibm.CisCertificateUpload("cisCertificateUploadResource", {
    certificate: "string",
    cisId: "string",
    domainId: "string",
    privateKey: "string",
    bundleMethod: "string",
    cisCertificateUploadId: "string",
    priority: 0,
});

type: ibm:CisCertificateUpload
properties:
    bundleMethod: string
    certificate: string
    cisCertificateUploadId: string
    cisId: string
    domainId: string
    priority: 0
    privateKey: string

CisCertificateUpload 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 CisCertificateUpload resource accepts the following input properties:

Certificate string: The intermediate(s) certificate key.
CisId string: The ID of the IBM Cloud Internet Services instance.
DomainId string: The ID of the domain to add the rules certificate upload.
PrivateKey string: The certificate private key.
BundleMethod string: The certificate bundle method. The valid values are ubiquitous, optimal, force.
CisCertificateUploadId string: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
Priority double: The order or priority in which the certificate is used in a request.

Certificate string: The intermediate(s) certificate key.
CisId string: The ID of the IBM Cloud Internet Services instance.
DomainId string: The ID of the domain to add the rules certificate upload.
PrivateKey string: The certificate private key.
BundleMethod string: The certificate bundle method. The valid values are ubiquitous, optimal, force.
CisCertificateUploadId string: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
Priority float64: The order or priority in which the certificate is used in a request.

certificate String: The intermediate(s) certificate key.
cisId String: The ID of the IBM Cloud Internet Services instance.
domainId String: The ID of the domain to add the rules certificate upload.
privateKey String: The certificate private key.
bundleMethod String: The certificate bundle method. The valid values are ubiquitous, optimal, force.
cisCertificateUploadId String: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
priority Double: The order or priority in which the certificate is used in a request.

certificate string: The intermediate(s) certificate key.
cisId string: The ID of the IBM Cloud Internet Services instance.
domainId string: The ID of the domain to add the rules certificate upload.
privateKey string: The certificate private key.
bundleMethod string: The certificate bundle method. The valid values are ubiquitous, optimal, force.
cisCertificateUploadId string: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
priority number: The order or priority in which the certificate is used in a request.

certificate str: The intermediate(s) certificate key.
cis_id str: The ID of the IBM Cloud Internet Services instance.
domain_id str: The ID of the domain to add the rules certificate upload.
private_key str: The certificate private key.
bundle_method str: The certificate bundle method. The valid values are ubiquitous, optimal, force.
cis_certificate_upload_id str: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
priority float: The order or priority in which the certificate is used in a request.

certificate String: The intermediate(s) certificate key.
cisId String: The ID of the IBM Cloud Internet Services instance.
domainId String: The ID of the domain to add the rules certificate upload.
privateKey String: The certificate private key.
bundleMethod String: The certificate bundle method. The valid values are ubiquitous, optimal, force.
cisCertificateUploadId String: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
priority Number: The order or priority in which the certificate is used in a request.

Outputs

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

CustomCertId string: (String) The certificate upload rule ID.
ExpiresOn string: (Timestamp) The expiry date and time of the certificate.
Hosts List<string>: hosts which the certificate uploaded to
Id string: The provider-assigned unique ID for this managed resource.
Issuer string: (String) The certificate issuer.
ModifiedOn string: (Timestamp) The modified date and time of the certificate.
Signature string: (String) The certificate signature.
Status string: (String) The certificate status.
UploadedOn string: (Timestamp) The uploaded date and time of the certificate.

CustomCertId string: (String) The certificate upload rule ID.
ExpiresOn string: (Timestamp) The expiry date and time of the certificate.
Hosts []string: hosts which the certificate uploaded to
Id string: The provider-assigned unique ID for this managed resource.
Issuer string: (String) The certificate issuer.
ModifiedOn string: (Timestamp) The modified date and time of the certificate.
Signature string: (String) The certificate signature.
Status string: (String) The certificate status.
UploadedOn string: (Timestamp) The uploaded date and time of the certificate.

customCertId String: (String) The certificate upload rule ID.
expiresOn String: (Timestamp) The expiry date and time of the certificate.
hosts List<String>: hosts which the certificate uploaded to
id String: The provider-assigned unique ID for this managed resource.
issuer String: (String) The certificate issuer.
modifiedOn String: (Timestamp) The modified date and time of the certificate.
signature String: (String) The certificate signature.
status String: (String) The certificate status.
uploadedOn String: (Timestamp) The uploaded date and time of the certificate.

customCertId string: (String) The certificate upload rule ID.
expiresOn string: (Timestamp) The expiry date and time of the certificate.
hosts string[]: hosts which the certificate uploaded to
id string: The provider-assigned unique ID for this managed resource.
issuer string: (String) The certificate issuer.
modifiedOn string: (Timestamp) The modified date and time of the certificate.
signature string: (String) The certificate signature.
status string: (String) The certificate status.
uploadedOn string: (Timestamp) The uploaded date and time of the certificate.

custom_cert_id str: (String) The certificate upload rule ID.
expires_on str: (Timestamp) The expiry date and time of the certificate.
hosts Sequence[str]: hosts which the certificate uploaded to
id str: The provider-assigned unique ID for this managed resource.
issuer str: (String) The certificate issuer.
modified_on str: (Timestamp) The modified date and time of the certificate.
signature str: (String) The certificate signature.
status str: (String) The certificate status.
uploaded_on str: (Timestamp) The uploaded date and time of the certificate.

customCertId String: (String) The certificate upload rule ID.
expiresOn String: (Timestamp) The expiry date and time of the certificate.
hosts List<String>: hosts which the certificate uploaded to
id String: The provider-assigned unique ID for this managed resource.
issuer String: (String) The certificate issuer.
modifiedOn String: (Timestamp) The modified date and time of the certificate.
signature String: (String) The certificate signature.
status String: (String) The certificate status.
uploadedOn String: (Timestamp) The uploaded date and time of the certificate.

Look up Existing CisCertificateUpload Resource

Get an existing CisCertificateUpload 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?: CisCertificateUploadState, opts?: CustomResourceOptions): CisCertificateUpload

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        bundle_method: Optional[str] = None,
        certificate: Optional[str] = None,
        cis_certificate_upload_id: Optional[str] = None,
        cis_id: Optional[str] = None,
        custom_cert_id: Optional[str] = None,
        domain_id: Optional[str] = None,
        expires_on: Optional[str] = None,
        hosts: Optional[Sequence[str]] = None,
        issuer: Optional[str] = None,
        modified_on: Optional[str] = None,
        priority: Optional[float] = None,
        private_key: Optional[str] = None,
        signature: Optional[str] = None,
        status: Optional[str] = None,
        uploaded_on: Optional[str] = None) -> CisCertificateUpload

func GetCisCertificateUpload(ctx *Context, name string, id IDInput, state *CisCertificateUploadState, opts ...ResourceOption) (*CisCertificateUpload, error)

public static CisCertificateUpload Get(string name, Input<string> id, CisCertificateUploadState? state, CustomResourceOptions? opts = null)

public static CisCertificateUpload get(String name, Output<String> id, CisCertificateUploadState state, CustomResourceOptions options)

resources:  _:    type: ibm:CisCertificateUpload    get:      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:

BundleMethod string: The certificate bundle method. The valid values are ubiquitous, optimal, force.
Certificate string: The intermediate(s) certificate key.
CisCertificateUploadId string: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
CisId string: The ID of the IBM Cloud Internet Services instance.
CustomCertId string: (String) The certificate upload rule ID.
DomainId string: The ID of the domain to add the rules certificate upload.
ExpiresOn string: (Timestamp) The expiry date and time of the certificate.
Hosts List<string>: hosts which the certificate uploaded to
Issuer string: (String) The certificate issuer.
ModifiedOn string: (Timestamp) The modified date and time of the certificate.
Priority double: The order or priority in which the certificate is used in a request.
PrivateKey string: The certificate private key.
Signature string: (String) The certificate signature.
Status string: (String) The certificate status.
UploadedOn string: (Timestamp) The uploaded date and time of the certificate.

BundleMethod string: The certificate bundle method. The valid values are ubiquitous, optimal, force.
Certificate string: The intermediate(s) certificate key.
CisCertificateUploadId string: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
CisId string: The ID of the IBM Cloud Internet Services instance.
CustomCertId string: (String) The certificate upload rule ID.
DomainId string: The ID of the domain to add the rules certificate upload.
ExpiresOn string: (Timestamp) The expiry date and time of the certificate.
Hosts []string: hosts which the certificate uploaded to
Issuer string: (String) The certificate issuer.
ModifiedOn string: (Timestamp) The modified date and time of the certificate.
Priority float64: The order or priority in which the certificate is used in a request.
PrivateKey string: The certificate private key.
Signature string: (String) The certificate signature.
Status string: (String) The certificate status.
UploadedOn string: (Timestamp) The uploaded date and time of the certificate.

bundleMethod String: The certificate bundle method. The valid values are ubiquitous, optimal, force.
certificate String: The intermediate(s) certificate key.
cisCertificateUploadId String: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
cisId String: The ID of the IBM Cloud Internet Services instance.
customCertId String: (String) The certificate upload rule ID.
domainId String: The ID of the domain to add the rules certificate upload.
expiresOn String: (Timestamp) The expiry date and time of the certificate.
hosts List<String>: hosts which the certificate uploaded to
issuer String: (String) The certificate issuer.
modifiedOn String: (Timestamp) The modified date and time of the certificate.
priority Double: The order or priority in which the certificate is used in a request.
privateKey String: The certificate private key.
signature String: (String) The certificate signature.
status String: (String) The certificate status.
uploadedOn String: (Timestamp) The uploaded date and time of the certificate.

bundleMethod string: The certificate bundle method. The valid values are ubiquitous, optimal, force.
certificate string: The intermediate(s) certificate key.
cisCertificateUploadId string: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
cisId string: The ID of the IBM Cloud Internet Services instance.
customCertId string: (String) The certificate upload rule ID.
domainId string: The ID of the domain to add the rules certificate upload.
expiresOn string: (Timestamp) The expiry date and time of the certificate.
hosts string[]: hosts which the certificate uploaded to
issuer string: (String) The certificate issuer.
modifiedOn string: (Timestamp) The modified date and time of the certificate.
priority number: The order or priority in which the certificate is used in a request.
privateKey string: The certificate private key.
signature string: (String) The certificate signature.
status string: (String) The certificate status.
uploadedOn string: (Timestamp) The uploaded date and time of the certificate.

bundle_method str: The certificate bundle method. The valid values are ubiquitous, optimal, force.
certificate str: The intermediate(s) certificate key.
cis_certificate_upload_id str: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
cis_id str: The ID of the IBM Cloud Internet Services instance.
custom_cert_id str: (String) The certificate upload rule ID.
domain_id str: The ID of the domain to add the rules certificate upload.
expires_on str: (Timestamp) The expiry date and time of the certificate.
hosts Sequence[str]: hosts which the certificate uploaded to
issuer str: (String) The certificate issuer.
modified_on str: (Timestamp) The modified date and time of the certificate.
priority float: The order or priority in which the certificate is used in a request.
private_key str: The certificate private key.
signature str: (String) The certificate signature.
status str: (String) The certificate status.
uploaded_on str: (Timestamp) The uploaded date and time of the certificate.

bundleMethod String: The certificate bundle method. The valid values are ubiquitous, optimal, force.
certificate String: The intermediate(s) certificate key.
cisCertificateUploadId String: (String) The record ID. It is a combination of <custom_cert_id>:<domain_id>:<cis_id> attributes concatenated with :.
cisId String: The ID of the IBM Cloud Internet Services instance.
customCertId String: (String) The certificate upload rule ID.
domainId String: The ID of the domain to add the rules certificate upload.
expiresOn String: (Timestamp) The expiry date and time of the certificate.
hosts List<String>: hosts which the certificate uploaded to
issuer String: (String) The certificate issuer.
modifiedOn String: (Timestamp) The modified date and time of the certificate.
priority Number: The order or priority in which the certificate is used in a request.
privateKey String: The certificate private key.
signature String: (String) The certificate signature.
status String: (String) The certificate status.
uploadedOn String: (Timestamp) The uploaded date and time of the certificate.

Import

The ibm_cis_certificate_upload resource can be imported by using the ID. The ID is formed from the certificate upload ID, the domain ID of the domain and the CRN Concatenated by using a : character.

The domain ID and CRN is located on the Overview page of the IBM Cloud Internet Services instance of the console domain heading, or by using the ibmcloud cis command line commands.

Domain ID is a 32 digit character string of the form: 9caf68812ae9b3f0377fdf986751a78f
CRN is a 120 digit character string of the form: crn:v1:bluemix:public:internet-svcs:global:a/4ea1882a2d3401ed1e459979941966ea:31fa970d-51d0-4b05-893e-251cba75a7b3::
Certificate upload ID is a 32 digit character string of the form: 489d96f0da6ed76251b475971b097205c.

Syntax

$ pulumi import ibm:index/cisCertificateUpload:CisCertificateUpload ratelimit <custm_cert_id>:<domain-id>:<crn>

Example

$ pulumi import ibm:index/cisCertificateUpload:CisCertificateUpload certificate 48996f0da6ed76251b475971b097205c:9caf68812ae9b3f0377fdf986751a78f:crn:v1:bluemix:public:internet-svcs:global:a/4ea1882a2d3401ed1e459979941966ea:31fa970d-51d0-4b05-893e-251cba75a7b3::

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository: ibm ibm-cloud/terraform-provider-ibm
License
Notes: This Pulumi package is based on the ibm Terraform Provider.

ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

ibm-cloud/terraform-provider-ibm

ibm.CisCertificateUpload

On this page

On this page

Create CisCertificateUpload Resource

Constructor syntax

Parameters

Constructor example

CisCertificateUpload Resource Properties

Inputs

Outputs

Look up Existing CisCertificateUpload Resource

Import

Package Details

On this page

On this page