Azure Classic

v5.25.0 published on Thursday, Nov 24, 2022 by Pulumi

Configuration

Manages a maintenance configuration.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Azure = Pulumi.Azure;

return await Deployment.RunAsync(() => 
{
    var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new()
    {
        Location = "West Europe",
    });

    var exampleConfiguration = new Azure.Maintenance.Configuration("exampleConfiguration", new()
    {
        ResourceGroupName = exampleResourceGroup.Name,
        Location = exampleResourceGroup.Location,
        Scope = "SQLDB",
        Tags = 
        {
            { "Env", "prod" },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/maintenance"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleResourceGroup, err := core.NewResourceGroup(ctx, "exampleResourceGroup", &core.ResourceGroupArgs{
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		_, err = maintenance.NewConfiguration(ctx, "exampleConfiguration", &maintenance.ConfigurationArgs{
			ResourceGroupName: exampleResourceGroup.Name,
			Location:          exampleResourceGroup.Location,
			Scope:             pulumi.String("SQLDB"),
			Tags: pulumi.StringMap{
				"Env": pulumi.String("prod"),
			},
		})
		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.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.maintenance.Configuration;
import com.pulumi.azure.maintenance.ConfigurationArgs;
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 exampleResourceGroup = new ResourceGroup("exampleResourceGroup", ResourceGroupArgs.builder()        
            .location("West Europe")
            .build());

        var exampleConfiguration = new Configuration("exampleConfiguration", ConfigurationArgs.builder()        
            .resourceGroupName(exampleResourceGroup.name())
            .location(exampleResourceGroup.location())
            .scope("SQLDB")
            .tags(Map.of("Env", "prod"))
            .build());

    }
}
import pulumi
import pulumi_azure as azure

example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="West Europe")
example_configuration = azure.maintenance.Configuration("exampleConfiguration",
    resource_group_name=example_resource_group.name,
    location=example_resource_group.location,
    scope="SQLDB",
    tags={
        "Env": "prod",
    })
import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "West Europe"});
const exampleConfiguration = new azure.maintenance.Configuration("exampleConfiguration", {
    resourceGroupName: exampleResourceGroup.name,
    location: exampleResourceGroup.location,
    scope: "SQLDB",
    tags: {
        Env: "prod",
    },
});
resources:
  exampleResourceGroup:
    type: azure:core:ResourceGroup
    properties:
      location: West Europe
  exampleConfiguration:
    type: azure:maintenance:Configuration
    properties:
      resourceGroupName: ${exampleResourceGroup.name}
      location: ${exampleResourceGroup.location}
      scope: SQLDB
      tags:
        Env: prod

Create Configuration Resource

new Configuration(name: string, args: ConfigurationArgs, opts?: CustomResourceOptions);
@overload
def Configuration(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  location: Optional[str] = None,
                  name: Optional[str] = None,
                  properties: Optional[Mapping[str, str]] = None,
                  resource_group_name: Optional[str] = None,
                  scope: Optional[str] = None,
                  tags: Optional[Mapping[str, str]] = None,
                  visibility: Optional[str] = None,
                  window: Optional[ConfigurationWindowArgs] = None)
@overload
def Configuration(resource_name: str,
                  args: ConfigurationArgs,
                  opts: Optional[ResourceOptions] = None)
func NewConfiguration(ctx *Context, name string, args ConfigurationArgs, opts ...ResourceOption) (*Configuration, error)
public Configuration(string name, ConfigurationArgs args, CustomResourceOptions? opts = null)
public Configuration(String name, ConfigurationArgs args)
public Configuration(String name, ConfigurationArgs args, CustomResourceOptions options)
type: azure:maintenance:Configuration
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

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

Configuration Resource Properties

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

Inputs

The Configuration resource accepts the following input properties:

ResourceGroupName string

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

Scope string

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

Location string

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

Name string

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

Properties Dictionary<string, string>

A mapping of properties to assign to the resource.

Tags Dictionary<string, string>

A mapping of tags to assign to the resource. The key could not contain upper case letter.

Visibility string

The visibility of the Maintenance Configuration. The only allowable value is Custom.

Window ConfigurationWindowArgs

A window block as defined below.

ResourceGroupName string

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

Scope string

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

Location string

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

Name string

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

Properties map[string]string

A mapping of properties to assign to the resource.

Tags map[string]string

A mapping of tags to assign to the resource. The key could not contain upper case letter.

Visibility string

The visibility of the Maintenance Configuration. The only allowable value is Custom.

Window ConfigurationWindowArgs

A window block as defined below.

resourceGroupName String

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

scope String

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

location String

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name String

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

properties Map<String,String>

A mapping of properties to assign to the resource.

tags Map<String,String>

A mapping of tags to assign to the resource. The key could not contain upper case letter.

visibility String

The visibility of the Maintenance Configuration. The only allowable value is Custom.

window ConfigurationWindowArgs

A window block as defined below.

resourceGroupName string

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

scope string

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

location string

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name string

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

properties {[key: string]: string}

A mapping of properties to assign to the resource.

tags {[key: string]: string}

A mapping of tags to assign to the resource. The key could not contain upper case letter.

visibility string

The visibility of the Maintenance Configuration. The only allowable value is Custom.

window ConfigurationWindowArgs

A window block as defined below.

resource_group_name str

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

scope str

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

location str

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name str

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

properties Mapping[str, str]

A mapping of properties to assign to the resource.

tags Mapping[str, str]

A mapping of tags to assign to the resource. The key could not contain upper case letter.

visibility str

The visibility of the Maintenance Configuration. The only allowable value is Custom.

window ConfigurationWindowArgs

A window block as defined below.

resourceGroupName String

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

scope String

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

location String

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name String

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

properties Map<String>

A mapping of properties to assign to the resource.

tags Map<String>

A mapping of tags to assign to the resource. The key could not contain upper case letter.

visibility String

The visibility of the Maintenance Configuration. The only allowable value is Custom.

window Property Map

A window block as defined below.

Outputs

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

Id string

The provider-assigned unique ID for this managed resource.

Id string

The provider-assigned unique ID for this managed resource.

id String

The provider-assigned unique ID for this managed resource.

id string

The provider-assigned unique ID for this managed resource.

id str

The provider-assigned unique ID for this managed resource.

id String

The provider-assigned unique ID for this managed resource.

Look up Existing Configuration Resource

Get an existing Configuration 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?: ConfigurationState, opts?: CustomResourceOptions): Configuration
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        location: Optional[str] = None,
        name: Optional[str] = None,
        properties: Optional[Mapping[str, str]] = None,
        resource_group_name: Optional[str] = None,
        scope: Optional[str] = None,
        tags: Optional[Mapping[str, str]] = None,
        visibility: Optional[str] = None,
        window: Optional[ConfigurationWindowArgs] = None) -> Configuration
func GetConfiguration(ctx *Context, name string, id IDInput, state *ConfigurationState, opts ...ResourceOption) (*Configuration, error)
public static Configuration Get(string name, Input<string> id, ConfigurationState? state, CustomResourceOptions? opts = null)
public static Configuration get(String name, Output<String> id, ConfigurationState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
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:
Location string

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

Name string

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

Properties Dictionary<string, string>

A mapping of properties to assign to the resource.

ResourceGroupName string

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

Scope string

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

Tags Dictionary<string, string>

A mapping of tags to assign to the resource. The key could not contain upper case letter.

Visibility string

The visibility of the Maintenance Configuration. The only allowable value is Custom.

Window ConfigurationWindowArgs

A window block as defined below.

Location string

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

Name string

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

Properties map[string]string

A mapping of properties to assign to the resource.

ResourceGroupName string

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

Scope string

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

Tags map[string]string

A mapping of tags to assign to the resource. The key could not contain upper case letter.

Visibility string

The visibility of the Maintenance Configuration. The only allowable value is Custom.

Window ConfigurationWindowArgs

A window block as defined below.

location String

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name String

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

properties Map<String,String>

A mapping of properties to assign to the resource.

resourceGroupName String

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

scope String

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

tags Map<String,String>

A mapping of tags to assign to the resource. The key could not contain upper case letter.

visibility String

The visibility of the Maintenance Configuration. The only allowable value is Custom.

window ConfigurationWindowArgs

A window block as defined below.

location string

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name string

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

properties {[key: string]: string}

A mapping of properties to assign to the resource.

resourceGroupName string

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

scope string

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

tags {[key: string]: string}

A mapping of tags to assign to the resource. The key could not contain upper case letter.

visibility string

The visibility of the Maintenance Configuration. The only allowable value is Custom.

window ConfigurationWindowArgs

A window block as defined below.

location str

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name str

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

properties Mapping[str, str]

A mapping of properties to assign to the resource.

resource_group_name str

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

scope str

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

tags Mapping[str, str]

A mapping of tags to assign to the resource. The key could not contain upper case letter.

visibility str

The visibility of the Maintenance Configuration. The only allowable value is Custom.

window ConfigurationWindowArgs

A window block as defined below.

location String

Specified the supported Azure location where the resource exists. Changing this forces a new resource to be created.

name String

Specifies the name of the Maintenance Configuration. Changing this forces a new resource to be created.

properties Map<String>

A mapping of properties to assign to the resource.

resourceGroupName String

The name of the Resource Group where the Maintenance Configuration should exist. Changing this forces a new resource to be created.

scope String

The scope of the Maintenance Configuration. Possible values are Extension, Host, InGuestPatch, OSImage, SQLDB or SQLManagedInstance.

tags Map<String>

A mapping of tags to assign to the resource. The key could not contain upper case letter.

visibility String

The visibility of the Maintenance Configuration. The only allowable value is Custom.

window Property Map

A window block as defined below.

Supporting Types

ConfigurationWindow

StartDateTime string

Effective start date of the maintenance window in YYYY-MM-DD hh:mm format.

TimeZone string

The time zone for the maintenance window. A list of timezones can be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell.

Duration string

The duration of the maintenance window in HH:mm format.

ExpirationDateTime string

Effective expiration date of the maintenance window in YYYY-MM-DD hh:mm format.

RecurEvery string

The rate at which a maintenance window is expected to recur. The rate can be expressed as daily, weekly, or monthly schedules.

StartDateTime string

Effective start date of the maintenance window in YYYY-MM-DD hh:mm format.

TimeZone string

The time zone for the maintenance window. A list of timezones can be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell.

Duration string

The duration of the maintenance window in HH:mm format.

ExpirationDateTime string

Effective expiration date of the maintenance window in YYYY-MM-DD hh:mm format.

RecurEvery string

The rate at which a maintenance window is expected to recur. The rate can be expressed as daily, weekly, or monthly schedules.

startDateTime String

Effective start date of the maintenance window in YYYY-MM-DD hh:mm format.

timeZone String

The time zone for the maintenance window. A list of timezones can be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell.

duration String

The duration of the maintenance window in HH:mm format.

expirationDateTime String

Effective expiration date of the maintenance window in YYYY-MM-DD hh:mm format.

recurEvery String

The rate at which a maintenance window is expected to recur. The rate can be expressed as daily, weekly, or monthly schedules.

startDateTime string

Effective start date of the maintenance window in YYYY-MM-DD hh:mm format.

timeZone string

The time zone for the maintenance window. A list of timezones can be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell.

duration string

The duration of the maintenance window in HH:mm format.

expirationDateTime string

Effective expiration date of the maintenance window in YYYY-MM-DD hh:mm format.

recurEvery string

The rate at which a maintenance window is expected to recur. The rate can be expressed as daily, weekly, or monthly schedules.

start_date_time str

Effective start date of the maintenance window in YYYY-MM-DD hh:mm format.

time_zone str

The time zone for the maintenance window. A list of timezones can be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell.

duration str

The duration of the maintenance window in HH:mm format.

expiration_date_time str

Effective expiration date of the maintenance window in YYYY-MM-DD hh:mm format.

recur_every str

The rate at which a maintenance window is expected to recur. The rate can be expressed as daily, weekly, or monthly schedules.

startDateTime String

Effective start date of the maintenance window in YYYY-MM-DD hh:mm format.

timeZone String

The time zone for the maintenance window. A list of timezones can be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell.

duration String

The duration of the maintenance window in HH:mm format.

expirationDateTime String

Effective expiration date of the maintenance window in YYYY-MM-DD hh:mm format.

recurEvery String

The rate at which a maintenance window is expected to recur. The rate can be expressed as daily, weekly, or monthly schedules.

Import

Maintenance Configuration can be imported using the resource id, e.g.

 $ pulumi import azure:maintenance/configuration:Configuration example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/microsoft.maintenance/maintenanceconfigurations/example-mc

Package Details

Repository
https://github.com/pulumi/pulumi-azure
License
Apache-2.0
Notes

This Pulumi package is based on the azurerm Terraform Provider.