cacheBlobTarget.go

// Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***

package hpc

import (
	"context"
	"reflect"

	"errors"
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/internal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

// Manages a Blob Target within a HPC Cache.
//
// > **NOTE:**: By request of the service team the provider no longer automatically registering the `Microsoft.StorageCache` Resource Provider for this resource. To register it you can run `az provider register --namespace 'Microsoft.StorageCache'`.
//
// ## Example Usage
//
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/authorization"
//	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
//	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/hpc"
//	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/network"
//	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/storage"
//	"github.com/pulumi/pulumi-azuread/sdk/v5/go/azuread"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			exampleResourceGroup, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
//				Name:     pulumi.String("example-resources"),
//				Location: pulumi.String("West Europe"),
//			})
//			if err != nil {
//				return err
//			}
//			exampleVirtualNetwork, err := network.NewVirtualNetwork(ctx, "example", &network.VirtualNetworkArgs{
//				Name: pulumi.String("examplevn"),
//				AddressSpaces: pulumi.StringArray{
//					pulumi.String("10.0.0.0/16"),
//				},
//				Location:          exampleResourceGroup.Location,
//				ResourceGroupName: exampleResourceGroup.Name,
//			})
//			if err != nil {
//				return err
//			}
//			exampleSubnet, err := network.NewSubnet(ctx, "example", &network.SubnetArgs{
//				Name:               pulumi.String("examplesubnet"),
//				ResourceGroupName:  exampleResourceGroup.Name,
//				VirtualNetworkName: exampleVirtualNetwork.Name,
//				AddressPrefixes: pulumi.StringArray{
//					pulumi.String("10.0.1.0/24"),
//				},
//			})
//			if err != nil {
//				return err
//			}
//			exampleCache, err := hpc.NewCache(ctx, "example", &hpc.CacheArgs{
//				Name:              pulumi.String("examplehpccache"),
//				ResourceGroupName: exampleResourceGroup.Name,
//				Location:          exampleResourceGroup.Location,
//				CacheSizeInGb:     pulumi.Int(3072),
//				SubnetId:          exampleSubnet.ID(),
//				SkuName:           pulumi.String("Standard_2G"),
//			})
//			if err != nil {
//				return err
//			}
//			exampleAccount, err := storage.NewAccount(ctx, "example", &storage.AccountArgs{
//				Name:                   pulumi.String("examplestorgaccount"),
//				ResourceGroupName:      exampleResourceGroup.Name,
//				Location:               exampleResourceGroup.Location,
//				AccountTier:            pulumi.String("Standard"),
//				AccountReplicationType: pulumi.String("LRS"),
//			})
//			if err != nil {
//				return err
//			}
//			exampleContainer, err := storage.NewContainer(ctx, "example", &storage.ContainerArgs{
//				Name:               pulumi.String("examplestoragecontainer"),
//				StorageAccountName: exampleAccount.Name,
//			})
//			if err != nil {
//				return err
//			}
//			example, err := azuread.LookupServicePrincipal(ctx, &azuread.LookupServicePrincipalArgs{
//				DisplayName: pulumi.StringRef("HPC Cache Resource Provider"),
//			}, nil)
//			if err != nil {
//				return err
//			}
//			_, err = authorization.NewAssignment(ctx, "example_storage_account_contrib", &authorization.AssignmentArgs{
//				Scope:              exampleAccount.ID(),
//				RoleDefinitionName: pulumi.String("Storage Account Contributor"),
//				PrincipalId:        pulumi.String(example.ObjectId),
//			})
//			if err != nil {
//				return err
//			}
//			_, err = authorization.NewAssignment(ctx, "example_storage_blob_data_contrib", &authorization.AssignmentArgs{
//				Scope:              exampleAccount.ID(),
//				RoleDefinitionName: pulumi.String("Storage Blob Data Contributor"),
//				PrincipalId:        pulumi.String(example.ObjectId),
//			})
//			if err != nil {
//				return err
//			}
//			_, err = hpc.NewCacheBlobTarget(ctx, "example", &hpc.CacheBlobTargetArgs{
//				Name:               pulumi.String("examplehpccblobtarget"),
//				ResourceGroupName:  exampleResourceGroup.Name,
//				CacheName:          exampleCache.Name,
//				StorageContainerId: exampleContainer.ResourceManagerId,
//				NamespacePath:      pulumi.String("/blob_storage"),
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
//
// ## Import
//
// Blob Targets within an HPC Cache can be imported using the `resource id`, e.g.
//
// ```sh
// $ pulumi import azure:hpc/cacheBlobTarget:CacheBlobTarget example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.StorageCache/caches/cache1/storageTargets/target1
// ```
type CacheBlobTarget struct {
	pulumi.CustomResourceState

	// The name of the access policy applied to this target. Defaults to `default`.
	AccessPolicyName pulumi.StringPtrOutput `pulumi:"accessPolicyName"`
	// The name HPC Cache, which the HPC Cache Blob Target will be added to. Changing this forces a new resource to be created.
	CacheName pulumi.StringOutput `pulumi:"cacheName"`
	// The name of the HPC Cache Blob Target. Changing this forces a new resource to be created.
	Name pulumi.StringOutput `pulumi:"name"`
	// The client-facing file path of the HPC Cache Blob Target.
	NamespacePath pulumi.StringOutput `pulumi:"namespacePath"`
	// The name of the Resource Group in which to create the HPC Cache Blob Target. Changing this forces a new resource to be created.
	ResourceGroupName pulumi.StringOutput `pulumi:"resourceGroupName"`
	// The Resource Manager ID of the Storage Container used as the HPC Cache Blob Target. Changing this forces a new resource to be created.
	//
	// > **Note:** This is the Resource Manager ID of the Storage Container, rather than the regular ID - and can be accessed on the `storage.Container` Data Source/Resource as `resourceManagerId`.
	StorageContainerId pulumi.StringOutput `pulumi:"storageContainerId"`
}

// NewCacheBlobTarget registers a new resource with the given unique name, arguments, and options.
func NewCacheBlobTarget(ctx *pulumi.Context,
	name string, args *CacheBlobTargetArgs, opts ...pulumi.ResourceOption) (*CacheBlobTarget, error) {
	if args == nil {
		return nil, errors.New("missing one or more required arguments")
	}

	if args.CacheName == nil {
		return nil, errors.New("invalid value for required argument 'CacheName'")
	}
	if args.NamespacePath == nil {
		return nil, errors.New("invalid value for required argument 'NamespacePath'")
	}
	if args.ResourceGroupName == nil {
		return nil, errors.New("invalid value for required argument 'ResourceGroupName'")
	}
	if args.StorageContainerId == nil {
		return nil, errors.New("invalid value for required argument 'StorageContainerId'")
	}
	opts = internal.PkgResourceDefaultOpts(opts)
	var resource CacheBlobTarget
	err := ctx.RegisterResource("azure:hpc/cacheBlobTarget:CacheBlobTarget", name, args, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// GetCacheBlobTarget gets an existing CacheBlobTarget resource's state with the given name, ID, and optional
// state properties that are used to uniquely qualify the lookup (nil if not required).
func GetCacheBlobTarget(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *CacheBlobTargetState, opts ...pulumi.ResourceOption) (*CacheBlobTarget, error) {
	var resource CacheBlobTarget
	err := ctx.ReadResource("azure:hpc/cacheBlobTarget:CacheBlobTarget", name, id, state, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// Input properties used for looking up and filtering CacheBlobTarget resources.
type cacheBlobTargetState struct {
	// The name of the access policy applied to this target. Defaults to `default`.
	AccessPolicyName *string `pulumi:"accessPolicyName"`
	// The name HPC Cache, which the HPC Cache Blob Target will be added to. Changing this forces a new resource to be created.
	CacheName *string `pulumi:"cacheName"`
	// The name of the HPC Cache Blob Target. Changing this forces a new resource to be created.
	Name *string `pulumi:"name"`
	// The client-facing file path of the HPC Cache Blob Target.
	NamespacePath *string `pulumi:"namespacePath"`
	// The name of the Resource Group in which to create the HPC Cache Blob Target. Changing this forces a new resource to be created.
	ResourceGroupName *string `pulumi:"resourceGroupName"`
	// The Resource Manager ID of the Storage Container used as the HPC Cache Blob Target. Changing this forces a new resource to be created.
	//
	// > **Note:** This is the Resource Manager ID of the Storage Container, rather than the regular ID - and can be accessed on the `storage.Container` Data Source/Resource as `resourceManagerId`.
	StorageContainerId *string `pulumi:"storageContainerId"`
}

type CacheBlobTargetState struct {
	// The name of the access policy applied to this target. Defaults to `default`.
	AccessPolicyName pulumi.StringPtrInput
	// The name HPC Cache, which the HPC Cache Blob Target will be added to. Changing this forces a new resource to be created.
	CacheName pulumi.StringPtrInput
	// The name of the HPC Cache Blob Target. Changing this forces a new resource to be created.
	Name pulumi.StringPtrInput
	// The client-facing file path of the HPC Cache Blob Target.
	NamespacePath pulumi.StringPtrInput
	// The name of the Resource Group in which to create the HPC Cache Blob Target. Changing this forces a new resource to be created.
	ResourceGroupName pulumi.StringPtrInput
	// The Resource Manager ID of the Storage Container used as the HPC Cache Blob Target. Changing this forces a new resource to be created.
	//
	// > **Note:** This is the Resource Manager ID of the Storage Container, rather than the regular ID - and can be accessed on the `storage.Container` Data Source/Resource as `resourceManagerId`.
	StorageContainerId pulumi.StringPtrInput
}

func (CacheBlobTargetState) ElementType() reflect.Type {
	return reflect.TypeOf((*cacheBlobTargetState)(nil)).Elem()
}

type cacheBlobTargetArgs struct {
	// The name of the access policy applied to this target. Defaults to `default`.
	AccessPolicyName *string `pulumi:"accessPolicyName"`
	// The name HPC Cache, which the HPC Cache Blob Target will be added to. Changing this forces a new resource to be created.
	CacheName string `pulumi:"cacheName"`
	// The name of the HPC Cache Blob Target. Changing this forces a new resource to be created.
	Name *string `pulumi:"name"`
	// The client-facing file path of the HPC Cache Blob Target.
	NamespacePath string `pulumi:"namespacePath"`
	// The name of the Resource Group in which to create the HPC Cache Blob Target. Changing this forces a new resource to be created.
	ResourceGroupName string `pulumi:"resourceGroupName"`
	// The Resource Manager ID of the Storage Container used as the HPC Cache Blob Target. Changing this forces a new resource to be created.
	//
	// > **Note:** This is the Resource Manager ID of the Storage Container, rather than the regular ID - and can be accessed on the `storage.Container` Data Source/Resource as `resourceManagerId`.
	StorageContainerId string `pulumi:"storageContainerId"`
}

// The set of arguments for constructing a CacheBlobTarget resource.
type CacheBlobTargetArgs struct {
	// The name of the access policy applied to this target. Defaults to `default`.
	AccessPolicyName pulumi.StringPtrInput
	// The name HPC Cache, which the HPC Cache Blob Target will be added to. Changing this forces a new resource to be created.
	CacheName pulumi.StringInput
	// The name of the HPC Cache Blob Target. Changing this forces a new resource to be created.
	Name pulumi.StringPtrInput
	// The client-facing file path of the HPC Cache Blob Target.
	NamespacePath pulumi.StringInput
	// The name of the Resource Group in which to create the HPC Cache Blob Target. Changing this forces a new resource to be created.
	ResourceGroupName pulumi.StringInput
	// The Resource Manager ID of the Storage Container used as the HPC Cache Blob Target. Changing this forces a new resource to be created.
	//
	// > **Note:** This is the Resource Manager ID of the Storage Container, rather than the regular ID - and can be accessed on the `storage.Container` Data Source/Resource as `resourceManagerId`.
	StorageContainerId pulumi.StringInput
}

func (CacheBlobTargetArgs) ElementType() reflect.Type {
	return reflect.TypeOf((*cacheBlobTargetArgs)(nil)).Elem()
}

type CacheBlobTargetInput interface {
	pulumi.Input

	ToCacheBlobTargetOutput() CacheBlobTargetOutput
	ToCacheBlobTargetOutputWithContext(ctx context.Context) CacheBlobTargetOutput
}

func (*CacheBlobTarget) ElementType() reflect.Type {
	return reflect.TypeOf((**CacheBlobTarget)(nil)).Elem()
}

func (i *CacheBlobTarget) ToCacheBlobTargetOutput() CacheBlobTargetOutput {
	return i.ToCacheBlobTargetOutputWithContext(context.Background())
}

func (i *CacheBlobTarget) ToCacheBlobTargetOutputWithContext(ctx context.Context) CacheBlobTargetOutput {
	return pulumi.ToOutputWithContext(ctx, i).(CacheBlobTargetOutput)
}

// CacheBlobTargetArrayInput is an input type that accepts CacheBlobTargetArray and CacheBlobTargetArrayOutput values.
// You can construct a concrete instance of `CacheBlobTargetArrayInput` via:
//
//	CacheBlobTargetArray{ CacheBlobTargetArgs{...} }
type CacheBlobTargetArrayInput interface {
	pulumi.Input

	ToCacheBlobTargetArrayOutput() CacheBlobTargetArrayOutput
	ToCacheBlobTargetArrayOutputWithContext(context.Context) CacheBlobTargetArrayOutput
}

type CacheBlobTargetArray []CacheBlobTargetInput

func (CacheBlobTargetArray) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*CacheBlobTarget)(nil)).Elem()
}

func (i CacheBlobTargetArray) ToCacheBlobTargetArrayOutput() CacheBlobTargetArrayOutput {
	return i.ToCacheBlobTargetArrayOutputWithContext(context.Background())
}

func (i CacheBlobTargetArray) ToCacheBlobTargetArrayOutputWithContext(ctx context.Context) CacheBlobTargetArrayOutput {
	return pulumi.ToOutputWithContext(ctx, i).(CacheBlobTargetArrayOutput)
}

// CacheBlobTargetMapInput is an input type that accepts CacheBlobTargetMap and CacheBlobTargetMapOutput values.
// You can construct a concrete instance of `CacheBlobTargetMapInput` via:
//
//	CacheBlobTargetMap{ "key": CacheBlobTargetArgs{...} }
type CacheBlobTargetMapInput interface {
	pulumi.Input

	ToCacheBlobTargetMapOutput() CacheBlobTargetMapOutput
	ToCacheBlobTargetMapOutputWithContext(context.Context) CacheBlobTargetMapOutput
}

type CacheBlobTargetMap map[string]CacheBlobTargetInput

func (CacheBlobTargetMap) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*CacheBlobTarget)(nil)).Elem()
}

func (i CacheBlobTargetMap) ToCacheBlobTargetMapOutput() CacheBlobTargetMapOutput {
	return i.ToCacheBlobTargetMapOutputWithContext(context.Background())
}

func (i CacheBlobTargetMap) ToCacheBlobTargetMapOutputWithContext(ctx context.Context) CacheBlobTargetMapOutput {
	return pulumi.ToOutputWithContext(ctx, i).(CacheBlobTargetMapOutput)
}

type CacheBlobTargetOutput struct{ *pulumi.OutputState }

func (CacheBlobTargetOutput) ElementType() reflect.Type {
	return reflect.TypeOf((**CacheBlobTarget)(nil)).Elem()
}

func (o CacheBlobTargetOutput) ToCacheBlobTargetOutput() CacheBlobTargetOutput {
	return o
}

func (o CacheBlobTargetOutput) ToCacheBlobTargetOutputWithContext(ctx context.Context) CacheBlobTargetOutput {
	return o
}

// The name of the access policy applied to this target. Defaults to `default`.
func (o CacheBlobTargetOutput) AccessPolicyName() pulumi.StringPtrOutput {
	return o.ApplyT(func(v *CacheBlobTarget) pulumi.StringPtrOutput { return v.AccessPolicyName }).(pulumi.StringPtrOutput)
}

// The name HPC Cache, which the HPC Cache Blob Target will be added to. Changing this forces a new resource to be created.
func (o CacheBlobTargetOutput) CacheName() pulumi.StringOutput {
	return o.ApplyT(func(v *CacheBlobTarget) pulumi.StringOutput { return v.CacheName }).(pulumi.StringOutput)
}

// The name of the HPC Cache Blob Target. Changing this forces a new resource to be created.
func (o CacheBlobTargetOutput) Name() pulumi.StringOutput {
	return o.ApplyT(func(v *CacheBlobTarget) pulumi.StringOutput { return v.Name }).(pulumi.StringOutput)
}

// The client-facing file path of the HPC Cache Blob Target.
func (o CacheBlobTargetOutput) NamespacePath() pulumi.StringOutput {
	return o.ApplyT(func(v *CacheBlobTarget) pulumi.StringOutput { return v.NamespacePath }).(pulumi.StringOutput)
}

// The name of the Resource Group in which to create the HPC Cache Blob Target. Changing this forces a new resource to be created.
func (o CacheBlobTargetOutput) ResourceGroupName() pulumi.StringOutput {
	return o.ApplyT(func(v *CacheBlobTarget) pulumi.StringOutput { return v.ResourceGroupName }).(pulumi.StringOutput)
}

// The Resource Manager ID of the Storage Container used as the HPC Cache Blob Target. Changing this forces a new resource to be created.
//
// > **Note:** This is the Resource Manager ID of the Storage Container, rather than the regular ID - and can be accessed on the `storage.Container` Data Source/Resource as `resourceManagerId`.
func (o CacheBlobTargetOutput) StorageContainerId() pulumi.StringOutput {
	return o.ApplyT(func(v *CacheBlobTarget) pulumi.StringOutput { return v.StorageContainerId }).(pulumi.StringOutput)
}

type CacheBlobTargetArrayOutput struct{ *pulumi.OutputState }

func (CacheBlobTargetArrayOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*CacheBlobTarget)(nil)).Elem()
}

func (o CacheBlobTargetArrayOutput) ToCacheBlobTargetArrayOutput() CacheBlobTargetArrayOutput {
	return o
}

func (o CacheBlobTargetArrayOutput) ToCacheBlobTargetArrayOutputWithContext(ctx context.Context) CacheBlobTargetArrayOutput {
	return o
}

func (o CacheBlobTargetArrayOutput) Index(i pulumi.IntInput) CacheBlobTargetOutput {
	return pulumi.All(o, i).ApplyT(func(vs []interface{}) *CacheBlobTarget {
		return vs[0].([]*CacheBlobTarget)[vs[1].(int)]
	}).(CacheBlobTargetOutput)
}

type CacheBlobTargetMapOutput struct{ *pulumi.OutputState }

func (CacheBlobTargetMapOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*CacheBlobTarget)(nil)).Elem()
}

func (o CacheBlobTargetMapOutput) ToCacheBlobTargetMapOutput() CacheBlobTargetMapOutput {
	return o
}

func (o CacheBlobTargetMapOutput) ToCacheBlobTargetMapOutputWithContext(ctx context.Context) CacheBlobTargetMapOutput {
	return o
}

func (o CacheBlobTargetMapOutput) MapIndex(k pulumi.StringInput) CacheBlobTargetOutput {
	return pulumi.All(o, k).ApplyT(func(vs []interface{}) *CacheBlobTarget {
		return vs[0].(map[string]*CacheBlobTarget)[vs[1].(string)]
	}).(CacheBlobTargetOutput)
}

func init() {
	pulumi.RegisterInputType(reflect.TypeOf((*CacheBlobTargetInput)(nil)).Elem(), &CacheBlobTarget{})
	pulumi.RegisterInputType(reflect.TypeOf((*CacheBlobTargetArrayInput)(nil)).Elem(), CacheBlobTargetArray{})
	pulumi.RegisterInputType(reflect.TypeOf((*CacheBlobTargetMapInput)(nil)).Elem(), CacheBlobTargetMap{})
	pulumi.RegisterOutputType(CacheBlobTargetOutput{})
	pulumi.RegisterOutputType(CacheBlobTargetArrayOutput{})
	pulumi.RegisterOutputType(CacheBlobTargetMapOutput{})
}