azure-native.workloads.Connector
Explore with Pulumi AI
Define the connector resource.
Uses Azure REST API version 2023-10-01-preview.
Example Usage
Create a connector resource.
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() => 
{
    var connector = new AzureNative.Workloads.Connector("connector", new()
    {
        ConnectorName = "C1",
        Location = "westcentralus",
        ResourceGroupName = "test-rg",
        SourceResourceId = "/subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00",
        Tags = null,
    });
});
package main
import (
	workloads "github.com/pulumi/pulumi-azure-native-sdk/workloads/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := workloads.NewConnector(ctx, "connector", &workloads.ConnectorArgs{
			ConnectorName:     pulumi.String("C1"),
			Location:          pulumi.String("westcentralus"),
			ResourceGroupName: pulumi.String("test-rg"),
			SourceResourceId:  pulumi.String("/subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00"),
			Tags:              pulumi.StringMap{},
		})
		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.workloads.Connector;
import com.pulumi.azurenative.workloads.ConnectorArgs;
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 connector = new Connector("connector", ConnectorArgs.builder()
            .connectorName("C1")
            .location("westcentralus")
            .resourceGroupName("test-rg")
            .sourceResourceId("/subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00")
            .tags()
            .build());
    }
}
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";
const connector = new azure_native.workloads.Connector("connector", {
    connectorName: "C1",
    location: "westcentralus",
    resourceGroupName: "test-rg",
    sourceResourceId: "/subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00",
    tags: {},
});
import pulumi
import pulumi_azure_native as azure_native
connector = azure_native.workloads.Connector("connector",
    connector_name="C1",
    location="westcentralus",
    resource_group_name="test-rg",
    source_resource_id="/subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00",
    tags={})
resources:
  connector:
    type: azure-native:workloads:Connector
    properties:
      connectorName: C1
      location: westcentralus
      resourceGroupName: test-rg
      sourceResourceId: /subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00
      tags: {}
Create Connector Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Connector(name: string, args: ConnectorArgs, opts?: CustomResourceOptions);@overload
def Connector(resource_name: str,
              args: ConnectorArgs,
              opts: Optional[ResourceOptions] = None)
@overload
def Connector(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              resource_group_name: Optional[str] = None,
              source_resource_id: Optional[str] = None,
              connector_name: Optional[str] = None,
              identity: Optional[UserAssignedServiceIdentityArgs] = None,
              location: Optional[str] = None,
              managed_resource_group_configuration: Optional[ManagedRGConfigurationArgs] = None,
              tags: Optional[Mapping[str, str]] = None)func NewConnector(ctx *Context, name string, args ConnectorArgs, opts ...ResourceOption) (*Connector, error)public Connector(string name, ConnectorArgs args, CustomResourceOptions? opts = null)
public Connector(String name, ConnectorArgs args)
public Connector(String name, ConnectorArgs args, CustomResourceOptions options)
type: azure-native:workloads:Connector
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 ConnectorArgs
- 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 ConnectorArgs
- 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 ConnectorArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ConnectorArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ConnectorArgs
- 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 exampleconnectorResourceResourceFromWorkloads = new AzureNative.Workloads.Connector("exampleconnectorResourceResourceFromWorkloads", new()
{
    ResourceGroupName = "string",
    SourceResourceId = "string",
    ConnectorName = "string",
    Identity = new AzureNative.Workloads.Inputs.UserAssignedServiceIdentityArgs
    {
        Type = "string",
        UserAssignedIdentities = new[]
        {
            "string",
        },
    },
    Location = "string",
    ManagedResourceGroupConfiguration = new AzureNative.Workloads.Inputs.ManagedRGConfigurationArgs
    {
        Name = "string",
    },
    Tags = 
    {
        { "string", "string" },
    },
});
example, err := workloads.NewConnector(ctx, "exampleconnectorResourceResourceFromWorkloads", &workloads.ConnectorArgs{
	ResourceGroupName: pulumi.String("string"),
	SourceResourceId:  pulumi.String("string"),
	ConnectorName:     pulumi.String("string"),
	Identity: &workloads.UserAssignedServiceIdentityArgs{
		Type: pulumi.String("string"),
		UserAssignedIdentities: pulumi.StringArray{
			pulumi.String("string"),
		},
	},
	Location: pulumi.String("string"),
	ManagedResourceGroupConfiguration: &workloads.ManagedRGConfigurationArgs{
		Name: pulumi.String("string"),
	},
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
})
var exampleconnectorResourceResourceFromWorkloads = new Connector("exampleconnectorResourceResourceFromWorkloads", ConnectorArgs.builder()
    .resourceGroupName("string")
    .sourceResourceId("string")
    .connectorName("string")
    .identity(UserAssignedServiceIdentityArgs.builder()
        .type("string")
        .userAssignedIdentities("string")
        .build())
    .location("string")
    .managedResourceGroupConfiguration(ManagedRGConfigurationArgs.builder()
        .name("string")
        .build())
    .tags(Map.of("string", "string"))
    .build());
exampleconnector_resource_resource_from_workloads = azure_native.workloads.Connector("exampleconnectorResourceResourceFromWorkloads",
    resource_group_name="string",
    source_resource_id="string",
    connector_name="string",
    identity={
        "type": "string",
        "user_assigned_identities": ["string"],
    },
    location="string",
    managed_resource_group_configuration={
        "name": "string",
    },
    tags={
        "string": "string",
    })
const exampleconnectorResourceResourceFromWorkloads = new azure_native.workloads.Connector("exampleconnectorResourceResourceFromWorkloads", {
    resourceGroupName: "string",
    sourceResourceId: "string",
    connectorName: "string",
    identity: {
        type: "string",
        userAssignedIdentities: ["string"],
    },
    location: "string",
    managedResourceGroupConfiguration: {
        name: "string",
    },
    tags: {
        string: "string",
    },
});
type: azure-native:workloads:Connector
properties:
    connectorName: string
    identity:
        type: string
        userAssignedIdentities:
            - string
    location: string
    managedResourceGroupConfiguration:
        name: string
    resourceGroupName: string
    sourceResourceId: string
    tags:
        string: string
Connector 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 Connector resource accepts the following input properties:
- ResourceGroup stringName 
- The name of the resource group. The name is case insensitive.
- SourceResource stringId 
- Defines the ID of the connector's source resource.
- ConnectorName string
- The name of the connector resource
- Identity
Pulumi.Azure Native. Workloads. Inputs. User Assigned Service Identity 
- Managed service identity (user assigned identities)
- Location string
- The geo-location where the resource lives
- ManagedResource Pulumi.Group Configuration Azure Native. Workloads. Inputs. Managed RGConfiguration 
- Managed resource group configuration
- Dictionary<string, string>
- Resource tags.
- ResourceGroup stringName 
- The name of the resource group. The name is case insensitive.
- SourceResource stringId 
- Defines the ID of the connector's source resource.
- ConnectorName string
- The name of the connector resource
- Identity
UserAssigned Service Identity Args 
- Managed service identity (user assigned identities)
- Location string
- The geo-location where the resource lives
- ManagedResource ManagedGroup Configuration RGConfiguration Args 
- Managed resource group configuration
- map[string]string
- Resource tags.
- resourceGroup StringName 
- The name of the resource group. The name is case insensitive.
- sourceResource StringId 
- Defines the ID of the connector's source resource.
- connectorName String
- The name of the connector resource
- identity
UserAssigned Service Identity 
- Managed service identity (user assigned identities)
- location String
- The geo-location where the resource lives
- managedResource ManagedGroup Configuration RGConfiguration 
- Managed resource group configuration
- Map<String,String>
- Resource tags.
- resourceGroup stringName 
- The name of the resource group. The name is case insensitive.
- sourceResource stringId 
- Defines the ID of the connector's source resource.
- connectorName string
- The name of the connector resource
- identity
UserAssigned Service Identity 
- Managed service identity (user assigned identities)
- location string
- The geo-location where the resource lives
- managedResource ManagedGroup Configuration RGConfiguration 
- Managed resource group configuration
- {[key: string]: string}
- Resource tags.
- resource_group_ strname 
- The name of the resource group. The name is case insensitive.
- source_resource_ strid 
- Defines the ID of the connector's source resource.
- connector_name str
- The name of the connector resource
- identity
UserAssigned Service Identity Args 
- Managed service identity (user assigned identities)
- location str
- The geo-location where the resource lives
- managed_resource_ Managedgroup_ configuration RGConfiguration Args 
- Managed resource group configuration
- Mapping[str, str]
- Resource tags.
- resourceGroup StringName 
- The name of the resource group. The name is case insensitive.
- sourceResource StringId 
- Defines the ID of the connector's source resource.
- connectorName String
- The name of the connector resource
- identity Property Map
- Managed service identity (user assigned identities)
- location String
- The geo-location where the resource lives
- managedResource Property MapGroup Configuration 
- Managed resource group configuration
- Map<String>
- Resource tags.
Outputs
All input properties are implicitly available as output properties. Additionally, the Connector resource produces the following output properties:
- Errors
Pulumi.Azure Native. Workloads. Outputs. Connector Error Definition Response 
- Indicates any errors on the connector resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The name of the resource
- ProvisioningState string
- Defines the provisioning states.
- SystemData Pulumi.Azure Native. Workloads. Outputs. System Data Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- Errors
ConnectorError Definition Response 
- Indicates any errors on the connector resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The name of the resource
- ProvisioningState string
- Defines the provisioning states.
- SystemData SystemData Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- errors
ConnectorError Definition Response 
- Indicates any errors on the connector resource.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The name of the resource
- provisioningState String
- Defines the provisioning states.
- systemData SystemData Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- errors
ConnectorError Definition Response 
- Indicates any errors on the connector resource.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- The name of the resource
- provisioningState string
- Defines the provisioning states.
- systemData SystemData Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- errors
ConnectorError Definition Response 
- Indicates any errors on the connector resource.
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- The name of the resource
- provisioning_state str
- Defines the provisioning states.
- system_data SystemData Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type str
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- errors Property Map
- Indicates any errors on the connector resource.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The name of the resource
- provisioningState String
- Defines the provisioning states.
- systemData Property Map
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
Supporting Types
ConnectorErrorDefinitionResponse, ConnectorErrorDefinitionResponseArgs        
- Code string
- Service specific error code which serves as the substatus for the HTTP error code.
- Details
List<Pulumi.Azure Native. Workloads. Inputs. Connector Error Definition Response> 
- Internal error details.
- Message string
- Description of the error.
- Code string
- Service specific error code which serves as the substatus for the HTTP error code.
- Details
[]ConnectorError Definition Response 
- Internal error details.
- Message string
- Description of the error.
- code String
- Service specific error code which serves as the substatus for the HTTP error code.
- details
List<ConnectorError Definition Response> 
- Internal error details.
- message String
- Description of the error.
- code string
- Service specific error code which serves as the substatus for the HTTP error code.
- details
ConnectorError Definition Response[] 
- Internal error details.
- message string
- Description of the error.
- code str
- Service specific error code which serves as the substatus for the HTTP error code.
- details
Sequence[ConnectorError Definition Response] 
- Internal error details.
- message str
- Description of the error.
- code String
- Service specific error code which serves as the substatus for the HTTP error code.
- details List<Property Map>
- Internal error details.
- message String
- Description of the error.
ManagedRGConfiguration, ManagedRGConfigurationArgs    
- Name string
- Managed resource group name
- Name string
- Managed resource group name
- name String
- Managed resource group name
- name string
- Managed resource group name
- name str
- Managed resource group name
- name String
- Managed resource group name
ManagedRGConfigurationResponse, ManagedRGConfigurationResponseArgs      
- Name string
- Managed resource group name
- Name string
- Managed resource group name
- name String
- Managed resource group name
- name string
- Managed resource group name
- name str
- Managed resource group name
- name String
- Managed resource group name
ManagedServiceIdentityType, ManagedServiceIdentityTypeArgs        
- None
- None
- UserAssigned 
- UserAssigned
- ManagedService Identity Type None 
- None
- ManagedService Identity Type User Assigned 
- UserAssigned
- None
- None
- UserAssigned 
- UserAssigned
- None
- None
- UserAssigned 
- UserAssigned
- NONE
- None
- USER_ASSIGNED
- UserAssigned
- "None"
- None
- "UserAssigned" 
- UserAssigned
SystemDataResponse, SystemDataResponseArgs      
- CreatedAt string
- The timestamp of resource creation (UTC).
- CreatedBy string
- The identity that created the resource.
- CreatedBy stringType 
- The type of identity that created the resource.
- LastModified stringAt 
- The timestamp of resource last modification (UTC)
- LastModified stringBy 
- The identity that last modified the resource.
- LastModified stringBy Type 
- The type of identity that last modified the resource.
- CreatedAt string
- The timestamp of resource creation (UTC).
- CreatedBy string
- The identity that created the resource.
- CreatedBy stringType 
- The type of identity that created the resource.
- LastModified stringAt 
- The timestamp of resource last modification (UTC)
- LastModified stringBy 
- The identity that last modified the resource.
- LastModified stringBy Type 
- The type of identity that last modified the resource.
- createdAt String
- The timestamp of resource creation (UTC).
- createdBy String
- The identity that created the resource.
- createdBy StringType 
- The type of identity that created the resource.
- lastModified StringAt 
- The timestamp of resource last modification (UTC)
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- The type of identity that last modified the resource.
- createdAt string
- The timestamp of resource creation (UTC).
- createdBy string
- The identity that created the resource.
- createdBy stringType 
- The type of identity that created the resource.
- lastModified stringAt 
- The timestamp of resource last modification (UTC)
- lastModified stringBy 
- The identity that last modified the resource.
- lastModified stringBy Type 
- The type of identity that last modified the resource.
- created_at str
- The timestamp of resource creation (UTC).
- created_by str
- The identity that created the resource.
- created_by_ strtype 
- The type of identity that created the resource.
- last_modified_ strat 
- The timestamp of resource last modification (UTC)
- last_modified_ strby 
- The identity that last modified the resource.
- last_modified_ strby_ type 
- The type of identity that last modified the resource.
- createdAt String
- The timestamp of resource creation (UTC).
- createdBy String
- The identity that created the resource.
- createdBy StringType 
- The type of identity that created the resource.
- lastModified StringAt 
- The timestamp of resource last modification (UTC)
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- The type of identity that last modified the resource.
UserAssignedIdentityResponse, UserAssignedIdentityResponseArgs        
- ClientId string
- The client ID of the assigned identity.
- PrincipalId string
- The principal ID of the assigned identity.
- ClientId string
- The client ID of the assigned identity.
- PrincipalId string
- The principal ID of the assigned identity.
- clientId String
- The client ID of the assigned identity.
- principalId String
- The principal ID of the assigned identity.
- clientId string
- The client ID of the assigned identity.
- principalId string
- The principal ID of the assigned identity.
- client_id str
- The client ID of the assigned identity.
- principal_id str
- The principal ID of the assigned identity.
- clientId String
- The client ID of the assigned identity.
- principalId String
- The principal ID of the assigned identity.
UserAssignedServiceIdentity, UserAssignedServiceIdentityArgs        
- Type
string | Pulumi.Azure Native. Workloads. Managed Service Identity Type 
- Type of manage identity
- UserAssigned List<string>Identities 
- User assigned identities dictionary
- Type
string | ManagedService Identity Type 
- Type of manage identity
- UserAssigned []stringIdentities 
- User assigned identities dictionary
- type
String | ManagedService Identity Type 
- Type of manage identity
- userAssigned List<String>Identities 
- User assigned identities dictionary
- type
string | ManagedService Identity Type 
- Type of manage identity
- userAssigned string[]Identities 
- User assigned identities dictionary
- type
str | ManagedService Identity Type 
- Type of manage identity
- user_assigned_ Sequence[str]identities 
- User assigned identities dictionary
- type
String | "None" | "UserAssigned" 
- Type of manage identity
- userAssigned List<String>Identities 
- User assigned identities dictionary
UserAssignedServiceIdentityResponse, UserAssignedServiceIdentityResponseArgs          
- Type string
- Type of manage identity
- UserAssigned Dictionary<string, Pulumi.Identities Azure Native. Workloads. Inputs. User Assigned Identity Response> 
- User assigned identities dictionary
- Type string
- Type of manage identity
- UserAssigned map[string]UserIdentities Assigned Identity Response 
- User assigned identities dictionary
- type String
- Type of manage identity
- userAssigned Map<String,UserIdentities Assigned Identity Response> 
- User assigned identities dictionary
- type string
- Type of manage identity
- userAssigned {[key: string]: UserIdentities Assigned Identity Response} 
- User assigned identities dictionary
- type str
- Type of manage identity
- user_assigned_ Mapping[str, Useridentities Assigned Identity Response] 
- User assigned identities dictionary
- type String
- Type of manage identity
- userAssigned Map<Property Map>Identities 
- User assigned identities dictionary
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:workloads:Connector C1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Workloads/connectors/{connectorName} 
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0