1. Packages
  2. Azure Native
  3. API Docs
  4. devices
  5. Certificate
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.73.0 published on Wednesday, Nov 20, 2024 by Pulumi

azure-native.devices.Certificate

Explore with Pulumi AI

azure-native logo
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.73.0 published on Wednesday, Nov 20, 2024 by Pulumi

    The X509 Certificate. Azure REST API version: 2022-04-30-preview. Prior API version in Azure Native 1.x: 2020-08-31.

    Other available API versions: 2020-04-01, 2022-11-15-preview, 2023-06-30, 2023-06-30-preview.

    Example Usage

    Certificates_CreateOrUpdate

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AzureNative = Pulumi.AzureNative;
    
    return await Deployment.RunAsync(() => 
    {
        var certificate = new AzureNative.Devices.Certificate("certificate", new()
        {
            CertificateName = "cert",
            Properties = new AzureNative.Devices.Inputs.CertificatePropertiesArgs
            {
                Certificate = "############################################",
            },
            ResourceGroupName = "myResourceGroup",
            ResourceName = "iothub",
        });
    
    });
    
    package main
    
    import (
    	devices "github.com/pulumi/pulumi-azure-native-sdk/devices/v2"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := devices.NewCertificate(ctx, "certificate", &devices.CertificateArgs{
    			CertificateName: pulumi.String("cert"),
    			Properties: &devices.CertificatePropertiesArgs{
    				Certificate: pulumi.String("############################################"),
    			},
    			ResourceGroupName: pulumi.String("myResourceGroup"),
    			ResourceName:      pulumi.String("iothub"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.azurenative.devices.Certificate;
    import com.pulumi.azurenative.devices.CertificateArgs;
    import com.pulumi.azurenative.devices.inputs.CertificatePropertiesArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var certificate = new Certificate("certificate", CertificateArgs.builder()
                .certificateName("cert")
                .properties(CertificatePropertiesArgs.builder()
                    .certificate("############################################")
                    .build())
                .resourceGroupName("myResourceGroup")
                .resourceName("iothub")
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_azure_native as azure_native
    
    certificate = azure_native.devices.Certificate("certificate",
        certificate_name="cert",
        properties={
            "certificate": "############################################",
        },
        resource_group_name="myResourceGroup",
        resource_name_="iothub")
    
    import * as pulumi from "@pulumi/pulumi";
    import * as azure_native from "@pulumi/azure-native";
    
    const certificate = new azure_native.devices.Certificate("certificate", {
        certificateName: "cert",
        properties: {
            certificate: "############################################",
        },
        resourceGroupName: "myResourceGroup",
        resourceName: "iothub",
    });
    
    resources:
      certificate:
        type: azure-native:devices:Certificate
        properties:
          certificateName: cert
          properties:
            certificate: '############################################'
          resourceGroupName: myResourceGroup
          resourceName: iothub
    

    Create Certificate Resource

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

    Constructor syntax

    new Certificate(name: string, args: CertificateArgs, opts?: CustomResourceOptions);
    @overload
    def Certificate(resource_name: str,
                    args: CertificateArgs,
                    opts: Optional[ResourceOptions] = None)
    
    @overload
    def Certificate(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    resource_group_name: Optional[str] = None,
                    resource_name_: Optional[str] = None,
                    certificate_name: Optional[str] = None,
                    properties: Optional[CertificatePropertiesArgs] = None)
    func NewCertificate(ctx *Context, name string, args CertificateArgs, opts ...ResourceOption) (*Certificate, error)
    public Certificate(string name, CertificateArgs args, CustomResourceOptions? opts = null)
    public Certificate(String name, CertificateArgs args)
    public Certificate(String name, CertificateArgs args, CustomResourceOptions options)
    
    type: azure-native:devices:Certificate
    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 CertificateArgs
    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 CertificateArgs
    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 CertificateArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CertificateArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CertificateArgs
    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 examplecertificateResourceResourceFromDevices = new AzureNative.Devices.Certificate("examplecertificateResourceResourceFromDevices", new()
    {
        ResourceGroupName = "string",
        ResourceName = "string",
        CertificateName = "string",
        Properties = new AzureNative.Devices.Inputs.CertificatePropertiesArgs
        {
            Certificate = "string",
            IsVerified = false,
        },
    });
    
    example, err := devices.NewCertificate(ctx, "examplecertificateResourceResourceFromDevices", &devices.CertificateArgs{
    	ResourceGroupName: pulumi.String("string"),
    	ResourceName:      pulumi.String("string"),
    	CertificateName:   pulumi.String("string"),
    	Properties: &devices.CertificatePropertiesArgs{
    		Certificate: pulumi.String("string"),
    		IsVerified:  pulumi.Bool(false),
    	},
    })
    
    var examplecertificateResourceResourceFromDevices = new Certificate("examplecertificateResourceResourceFromDevices", CertificateArgs.builder()
        .resourceGroupName("string")
        .resourceName("string")
        .certificateName("string")
        .properties(CertificatePropertiesArgs.builder()
            .certificate("string")
            .isVerified(false)
            .build())
        .build());
    
    examplecertificate_resource_resource_from_devices = azure_native.devices.Certificate("examplecertificateResourceResourceFromDevices",
        resource_group_name="string",
        resource_name_="string",
        certificate_name="string",
        properties={
            "certificate": "string",
            "is_verified": False,
        })
    
    const examplecertificateResourceResourceFromDevices = new azure_native.devices.Certificate("examplecertificateResourceResourceFromDevices", {
        resourceGroupName: "string",
        resourceName: "string",
        certificateName: "string",
        properties: {
            certificate: "string",
            isVerified: false,
        },
    });
    
    type: azure-native:devices:Certificate
    properties:
        certificateName: string
        properties:
            certificate: string
            isVerified: false
        resourceGroupName: string
        resourceName: string
    

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

    ResourceGroupName string
    The name of the resource group that contains the IoT hub.
    ResourceName string
    The name of the IoT hub.
    CertificateName string
    The name of the certificate
    Properties Pulumi.AzureNative.Devices.Inputs.CertificateProperties
    The description of an X509 CA Certificate.
    ResourceGroupName string
    The name of the resource group that contains the IoT hub.
    ResourceName string
    The name of the IoT hub.
    CertificateName string
    The name of the certificate
    Properties CertificatePropertiesArgs
    The description of an X509 CA Certificate.
    resourceGroupName String
    The name of the resource group that contains the IoT hub.
    resourceName String
    The name of the IoT hub.
    certificateName String
    The name of the certificate
    properties CertificateProperties
    The description of an X509 CA Certificate.
    resourceGroupName string
    The name of the resource group that contains the IoT hub.
    resourceName string
    The name of the IoT hub.
    certificateName string
    The name of the certificate
    properties CertificateProperties
    The description of an X509 CA Certificate.
    resource_group_name str
    The name of the resource group that contains the IoT hub.
    resource_name str
    The name of the IoT hub.
    certificate_name str
    The name of the certificate
    properties CertificatePropertiesArgs
    The description of an X509 CA Certificate.
    resourceGroupName String
    The name of the resource group that contains the IoT hub.
    resourceName String
    The name of the IoT hub.
    certificateName String
    The name of the certificate
    properties Property Map
    The description of an X509 CA Certificate.

    Outputs

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

    Etag string
    The entity tag.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    The name of the certificate.
    Type string
    The resource type.
    Etag string
    The entity tag.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    The name of the certificate.
    Type string
    The resource type.
    etag String
    The entity tag.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    The name of the certificate.
    type String
    The resource type.
    etag string
    The entity tag.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    The name of the certificate.
    type string
    The resource type.
    etag str
    The entity tag.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    The name of the certificate.
    type str
    The resource type.
    etag String
    The entity tag.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    The name of the certificate.
    type String
    The resource type.

    Supporting Types

    CertificateProperties, CertificatePropertiesArgs

    Certificate string
    base-64 representation of X509 certificate .cer file or just .pem file content.
    IsVerified bool
    Determines whether certificate has been verified.
    Certificate string
    base-64 representation of X509 certificate .cer file or just .pem file content.
    IsVerified bool
    Determines whether certificate has been verified.
    certificate String
    base-64 representation of X509 certificate .cer file or just .pem file content.
    isVerified Boolean
    Determines whether certificate has been verified.
    certificate string
    base-64 representation of X509 certificate .cer file or just .pem file content.
    isVerified boolean
    Determines whether certificate has been verified.
    certificate str
    base-64 representation of X509 certificate .cer file or just .pem file content.
    is_verified bool
    Determines whether certificate has been verified.
    certificate String
    base-64 representation of X509 certificate .cer file or just .pem file content.
    isVerified Boolean
    Determines whether certificate has been verified.

    CertificatePropertiesResponse, CertificatePropertiesResponseArgs

    Created string
    The certificate's creation date and time.
    Expiry string
    The certificate's expiration date and time.
    Subject string
    The certificate's subject name.
    Thumbprint string
    The certificate's thumbprint.
    Updated string
    The certificate's last update date and time.
    Certificate string
    base-64 representation of X509 certificate .cer file or just .pem file content.
    IsVerified bool
    Determines whether certificate has been verified.
    Created string
    The certificate's creation date and time.
    Expiry string
    The certificate's expiration date and time.
    Subject string
    The certificate's subject name.
    Thumbprint string
    The certificate's thumbprint.
    Updated string
    The certificate's last update date and time.
    Certificate string
    base-64 representation of X509 certificate .cer file or just .pem file content.
    IsVerified bool
    Determines whether certificate has been verified.
    created String
    The certificate's creation date and time.
    expiry String
    The certificate's expiration date and time.
    subject String
    The certificate's subject name.
    thumbprint String
    The certificate's thumbprint.
    updated String
    The certificate's last update date and time.
    certificate String
    base-64 representation of X509 certificate .cer file or just .pem file content.
    isVerified Boolean
    Determines whether certificate has been verified.
    created string
    The certificate's creation date and time.
    expiry string
    The certificate's expiration date and time.
    subject string
    The certificate's subject name.
    thumbprint string
    The certificate's thumbprint.
    updated string
    The certificate's last update date and time.
    certificate string
    base-64 representation of X509 certificate .cer file or just .pem file content.
    isVerified boolean
    Determines whether certificate has been verified.
    created str
    The certificate's creation date and time.
    expiry str
    The certificate's expiration date and time.
    subject str
    The certificate's subject name.
    thumbprint str
    The certificate's thumbprint.
    updated str
    The certificate's last update date and time.
    certificate str
    base-64 representation of X509 certificate .cer file or just .pem file content.
    is_verified bool
    Determines whether certificate has been verified.
    created String
    The certificate's creation date and time.
    expiry String
    The certificate's expiration date and time.
    subject String
    The certificate's subject name.
    thumbprint String
    The certificate's thumbprint.
    updated String
    The certificate's last update date and time.
    certificate String
    base-64 representation of X509 certificate .cer file or just .pem file content.
    isVerified Boolean
    Determines whether certificate has been verified.

    Import

    An existing resource can be imported using its type token, name, and identifier, e.g.

    $ pulumi import azure-native:devices:Certificate cert /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates/{certificateName} 
    

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

    Package Details

    Repository
    Azure Native pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
    Azure Native v2.73.0 published on Wednesday, Nov 20, 2024 by Pulumi