azure-native.datashare.Share
Explore with Pulumi AI
A share data transfer object.
Uses Azure REST API version 2021-08-01. In version 1.x of the Azure Native provider, it used API version 2020-09-01.
Example Usage
Shares_Create
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() => 
{
    var share = new AzureNative.DataShare.Share("share", new()
    {
        AccountName = "Account1",
        Description = "share description",
        ResourceGroupName = "SampleResourceGroup",
        ShareKind = AzureNative.DataShare.ShareKind.CopyBased,
        ShareName = "Share1",
        Terms = "Confidential",
    });
});
package main
import (
	datashare "github.com/pulumi/pulumi-azure-native-sdk/datashare/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := datashare.NewShare(ctx, "share", &datashare.ShareArgs{
			AccountName:       pulumi.String("Account1"),
			Description:       pulumi.String("share description"),
			ResourceGroupName: pulumi.String("SampleResourceGroup"),
			ShareKind:         pulumi.String(datashare.ShareKindCopyBased),
			ShareName:         pulumi.String("Share1"),
			Terms:             pulumi.String("Confidential"),
		})
		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.datashare.Share;
import com.pulumi.azurenative.datashare.ShareArgs;
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 share = new Share("share", ShareArgs.builder()
            .accountName("Account1")
            .description("share description")
            .resourceGroupName("SampleResourceGroup")
            .shareKind("CopyBased")
            .shareName("Share1")
            .terms("Confidential")
            .build());
    }
}
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";
const share = new azure_native.datashare.Share("share", {
    accountName: "Account1",
    description: "share description",
    resourceGroupName: "SampleResourceGroup",
    shareKind: azure_native.datashare.ShareKind.CopyBased,
    shareName: "Share1",
    terms: "Confidential",
});
import pulumi
import pulumi_azure_native as azure_native
share = azure_native.datashare.Share("share",
    account_name="Account1",
    description="share description",
    resource_group_name="SampleResourceGroup",
    share_kind=azure_native.datashare.ShareKind.COPY_BASED,
    share_name="Share1",
    terms="Confidential")
resources:
  share:
    type: azure-native:datashare:Share
    properties:
      accountName: Account1
      description: share description
      resourceGroupName: SampleResourceGroup
      shareKind: CopyBased
      shareName: Share1
      terms: Confidential
Create Share Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Share(name: string, args: ShareArgs, opts?: CustomResourceOptions);@overload
def Share(resource_name: str,
          args: ShareArgs,
          opts: Optional[ResourceOptions] = None)
@overload
def Share(resource_name: str,
          opts: Optional[ResourceOptions] = None,
          account_name: Optional[str] = None,
          resource_group_name: Optional[str] = None,
          description: Optional[str] = None,
          share_kind: Optional[Union[str, ShareKind]] = None,
          share_name: Optional[str] = None,
          terms: Optional[str] = None)func NewShare(ctx *Context, name string, args ShareArgs, opts ...ResourceOption) (*Share, error)public Share(string name, ShareArgs args, CustomResourceOptions? opts = null)type: azure-native:datashare:Share
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 ShareArgs
- 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 ShareArgs
- 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 ShareArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ShareArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ShareArgs
- 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 azure_nativeShareResource = new AzureNative.DataShare.Share("azure-nativeShareResource", new()
{
    AccountName = "string",
    ResourceGroupName = "string",
    Description = "string",
    ShareKind = "string",
    ShareName = "string",
    Terms = "string",
});
example, err := datashare.NewShare(ctx, "azure-nativeShareResource", &datashare.ShareArgs{
	AccountName:       pulumi.String("string"),
	ResourceGroupName: pulumi.String("string"),
	Description:       pulumi.String("string"),
	ShareKind:         pulumi.String("string"),
	ShareName:         pulumi.String("string"),
	Terms:             pulumi.String("string"),
})
var azure_nativeShareResource = new Share("azure-nativeShareResource", ShareArgs.builder()
    .accountName("string")
    .resourceGroupName("string")
    .description("string")
    .shareKind("string")
    .shareName("string")
    .terms("string")
    .build());
azure_native_share_resource = azure_native.datashare.Share("azure-nativeShareResource",
    account_name="string",
    resource_group_name="string",
    description="string",
    share_kind="string",
    share_name="string",
    terms="string")
const azure_nativeShareResource = new azure_native.datashare.Share("azure-nativeShareResource", {
    accountName: "string",
    resourceGroupName: "string",
    description: "string",
    shareKind: "string",
    shareName: "string",
    terms: "string",
});
type: azure-native:datashare:Share
properties:
    accountName: string
    description: string
    resourceGroupName: string
    shareKind: string
    shareName: string
    terms: string
Share 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 Share resource accepts the following input properties:
- AccountName string
- The name of the share account.
- ResourceGroup stringName 
- The resource group name.
- Description string
- Share description.
- 
string | Pulumi.Azure Native. Data Share. Share Kind 
- Share kind.
- string
- The name of the share.
- Terms string
- Share terms.
- AccountName string
- The name of the share account.
- ResourceGroup stringName 
- The resource group name.
- Description string
- Share description.
- 
string | ShareKind 
- Share kind.
- string
- The name of the share.
- Terms string
- Share terms.
- accountName String
- The name of the share account.
- resourceGroup StringName 
- The resource group name.
- description String
- Share description.
- 
String | ShareKind 
- Share kind.
- String
- The name of the share.
- terms String
- Share terms.
- accountName string
- The name of the share account.
- resourceGroup stringName 
- The resource group name.
- description string
- Share description.
- 
string | ShareKind 
- Share kind.
- string
- The name of the share.
- terms string
- Share terms.
- account_name str
- The name of the share account.
- resource_group_ strname 
- The resource group name.
- description str
- Share description.
- 
str | ShareKind 
- Share kind.
- str
- The name of the share.
- terms str
- Share terms.
- accountName String
- The name of the share account.
- resourceGroup StringName 
- The resource group name.
- description String
- Share description.
- 
String | "CopyBased" | "In Place" 
- Share kind.
- String
- The name of the share.
- terms String
- Share terms.
Outputs
All input properties are implicitly available as output properties. Additionally, the Share resource produces the following output properties:
- CreatedAt string
- Time at which the share was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- Name of the azure resource
- ProvisioningState string
- Gets or sets the provisioning state
- SystemData Pulumi.Azure Native. Data Share. Outputs. System Data Response 
- System Data of the Azure resource.
- Type string
- Type of the azure resource
- UserEmail string
- Email of the user who created the resource
- UserName string
- Name of the user who created the resource
- CreatedAt string
- Time at which the share was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- Name of the azure resource
- ProvisioningState string
- Gets or sets the provisioning state
- SystemData SystemData Response 
- System Data of the Azure resource.
- Type string
- Type of the azure resource
- UserEmail string
- Email of the user who created the resource
- UserName string
- Name of the user who created the resource
- createdAt String
- Time at which the share was created.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- Name of the azure resource
- provisioningState String
- Gets or sets the provisioning state
- systemData SystemData Response 
- System Data of the Azure resource.
- type String
- Type of the azure resource
- userEmail String
- Email of the user who created the resource
- userName String
- Name of the user who created the resource
- createdAt string
- Time at which the share was created.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- Name of the azure resource
- provisioningState string
- Gets or sets the provisioning state
- systemData SystemData Response 
- System Data of the Azure resource.
- type string
- Type of the azure resource
- userEmail string
- Email of the user who created the resource
- userName string
- Name of the user who created the resource
- created_at str
- Time at which the share was created.
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- Name of the azure resource
- provisioning_state str
- Gets or sets the provisioning state
- system_data SystemData Response 
- System Data of the Azure resource.
- type str
- Type of the azure resource
- user_email str
- Email of the user who created the resource
- user_name str
- Name of the user who created the resource
- createdAt String
- Time at which the share was created.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- Name of the azure resource
- provisioningState String
- Gets or sets the provisioning state
- systemData Property Map
- System Data of the Azure resource.
- type String
- Type of the azure resource
- userEmail String
- Email of the user who created the resource
- userName String
- Name of the user who created the resource
Supporting Types
ShareKind, ShareKindArgs    
- CopyBased 
- CopyBased
- InPlace 
- InPlace
- ShareKind Copy Based 
- CopyBased
- ShareKind In Place 
- InPlace
- CopyBased 
- CopyBased
- InPlace 
- InPlace
- CopyBased 
- CopyBased
- InPlace 
- InPlace
- COPY_BASED
- CopyBased
- IN_PLACE
- InPlace
- "CopyBased" 
- CopyBased
- "InPlace" 
- InPlace
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 type of identity that last modified the resource.
- 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 type of identity that last modified the resource.
- 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 type of identity that last modified the resource.
- 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 type of identity that last modified the resource.
- 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 type of identity that last modified the resource.
- 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 type of identity that last modified the resource.
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- The type of identity that last modified the resource.
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:datashare:Share Share1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName} 
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0