image

package
v0.1.8 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 26, 2024 License: Apache-2.0 Imports: 11 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func PkgVersion added in v0.0.5 

func PkgVersion() (semver.Version, error)

PkgVersion uses reflection to determine the version of the current package. If a version cannot be determined, v1 will be assumed. The second return value is always nil.

Types

type GetInstanceFilter 

type GetInstanceFilter struct {
	// Key of the filter, valid keys: `image-id`, `image-type`, `image-name`.
	Name string `pulumi:"name"`
	// Values of the filter.
	Values []string `pulumi:"values"`
}

type GetInstanceFilterArgs 

type GetInstanceFilterArgs struct {
	// Key of the filter, valid keys: `image-id`, `image-type`, `image-name`.
	Name pulumi.StringInput `pulumi:"name"`
	// Values of the filter.
	Values pulumi.StringArrayInput `pulumi:"values"`
}

func (GetInstanceFilterArgs) ElementType 

func (GetInstanceFilterArgs) ElementType() reflect.Type

func (GetInstanceFilterArgs) ToGetInstanceFilterOutput 

func (i GetInstanceFilterArgs) ToGetInstanceFilterOutput() GetInstanceFilterOutput

func (GetInstanceFilterArgs) ToGetInstanceFilterOutputWithContext 

func (i GetInstanceFilterArgs) ToGetInstanceFilterOutputWithContext(ctx context.Context) GetInstanceFilterOutput

type GetInstanceFilterArray 

type GetInstanceFilterArray []GetInstanceFilterInput

func (GetInstanceFilterArray) ElementType 

func (GetInstanceFilterArray) ElementType() reflect.Type

func (GetInstanceFilterArray) ToGetInstanceFilterArrayOutput 

func (i GetInstanceFilterArray) ToGetInstanceFilterArrayOutput() GetInstanceFilterArrayOutput

func (GetInstanceFilterArray) ToGetInstanceFilterArrayOutputWithContext 

func (i GetInstanceFilterArray) ToGetInstanceFilterArrayOutputWithContext(ctx context.Context) GetInstanceFilterArrayOutput

type GetInstanceFilterArrayInput 

type GetInstanceFilterArrayInput interface {
	pulumi.Input

	ToGetInstanceFilterArrayOutput() GetInstanceFilterArrayOutput
	ToGetInstanceFilterArrayOutputWithContext(context.Context) GetInstanceFilterArrayOutput
}

GetInstanceFilterArrayInput is an input type that accepts GetInstanceFilterArray and GetInstanceFilterArrayOutput values. You can construct a concrete instance of `GetInstanceFilterArrayInput` via: 

GetInstanceFilterArray{ GetInstanceFilterArgs{...} }

type GetInstanceFilterArrayOutput 

type GetInstanceFilterArrayOutput struct{ *pulumi.OutputState }

func (GetInstanceFilterArrayOutput) ElementType 

func (GetInstanceFilterArrayOutput) ElementType() reflect.Type

func (GetInstanceFilterArrayOutput) Index 

func (o GetInstanceFilterArrayOutput) Index(i pulumi.IntInput) GetInstanceFilterOutput

func (GetInstanceFilterArrayOutput) ToGetInstanceFilterArrayOutput 

func (o GetInstanceFilterArrayOutput) ToGetInstanceFilterArrayOutput() GetInstanceFilterArrayOutput

func (GetInstanceFilterArrayOutput) ToGetInstanceFilterArrayOutputWithContext 

func (o GetInstanceFilterArrayOutput) ToGetInstanceFilterArrayOutputWithContext(ctx context.Context) GetInstanceFilterArrayOutput

type GetInstanceFilterInput 

type GetInstanceFilterInput interface {
	pulumi.Input

	ToGetInstanceFilterOutput() GetInstanceFilterOutput
	ToGetInstanceFilterOutputWithContext(context.Context) GetInstanceFilterOutput
}

GetInstanceFilterInput is an input type that accepts GetInstanceFilterArgs and GetInstanceFilterOutput values. You can construct a concrete instance of `GetInstanceFilterInput` via: 

GetInstanceFilterArgs{...}

type GetInstanceFilterOutput 

type GetInstanceFilterOutput struct{ *pulumi.OutputState }

func (GetInstanceFilterOutput) ElementType 

func (GetInstanceFilterOutput) ElementType() reflect.Type

func (GetInstanceFilterOutput) Name 

func (o GetInstanceFilterOutput) Name() pulumi.StringOutput

Key of the filter, valid keys: `image-id`, `image-type`, `image-name`.

func (GetInstanceFilterOutput) ToGetInstanceFilterOutput 

func (o GetInstanceFilterOutput) ToGetInstanceFilterOutput() GetInstanceFilterOutput

func (GetInstanceFilterOutput) ToGetInstanceFilterOutputWithContext 

func (o GetInstanceFilterOutput) ToGetInstanceFilterOutputWithContext(ctx context.Context) GetInstanceFilterOutput

func (GetInstanceFilterOutput) Values 

func (o GetInstanceFilterOutput) Values() pulumi.StringArrayOutput

Values of the filter.

type Instance 

type Instance struct {
	pulumi.CustomResourceState

	// Cloud disk ID list, When creating a whole machine image based on an instance, specify the data disk ID contained in the image.
	DataDiskIds pulumi.StringArrayOutput `pulumi:"dataDiskIds"`
	// Set whether to force shutdown during mirroring. The default value is `false`, when set to true, it means that the mirror will be made after shutdown.
	ForcePoweroff pulumi.BoolPtrOutput `pulumi:"forcePoweroff"`
	// Image Description.
	ImageDescription pulumi.StringPtrOutput `pulumi:"imageDescription"`
	// Image name.
	ImageName pulumi.StringOutput `pulumi:"imageName"`
	// Cloud server instance ID.
	InstanceId pulumi.StringPtrOutput `pulumi:"instanceId"`
	// Cloud disk snapshot ID list; creating a mirror based on a snapshot must include a system disk snapshot. It cannot be passed in simultaneously with InstanceId.
	SnapshotIds pulumi.StringArrayOutput `pulumi:"snapshotIds"`
	// Sysprep function under Windows. When creating a Windows image, you can select true or false to enable or disable the Syspre function.
	Sysprep pulumi.BoolPtrOutput `pulumi:"sysprep"`
	// Tags of the image.
	Tags pulumi.MapOutput `pulumi:"tags"`
}

Provide a resource to manage image.

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/tencentcloudstack/pulumi-tencentcloud/sdk/go/tencentcloud/Image"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Image.NewInstance(ctx, "imageSnap", &Image.InstanceArgs{
			ForcePoweroff:    pulumi.Bool(true),
			ImageDescription: pulumi.String("create image with snapshot"),
			ImageName:        pulumi.String("image-snapshot-keep"),
			SnapshotIds: pulumi.StringArray{
				pulumi.String("snap-nbp3xy1d"),
				pulumi.String("snap-nvzu3dmh"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

image instance can be imported using the id, e.g.

```sh 

$ pulumi import tencentcloud:Image/instance:Instance image_snap img-gf7jspk6

```

func GetInstance 

func GetInstance(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *InstanceState, opts ...pulumi.ResourceOption) (*Instance, error)

GetInstance gets an existing Instance 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 NewInstance 

func NewInstance(ctx *pulumi.Context,
	name string, args *InstanceArgs, opts ...pulumi.ResourceOption) (*Instance, error)

NewInstance registers a new resource with the given unique name, arguments, and options.

func (*Instance) ElementType 

func (*Instance) ElementType() reflect.Type

func (*Instance) ToInstanceOutput 

func (i *Instance) ToInstanceOutput() InstanceOutput

func (*Instance) ToInstanceOutputWithContext 

func (i *Instance) ToInstanceOutputWithContext(ctx context.Context) InstanceOutput

type InstanceArgs 

type InstanceArgs struct {
	// Cloud disk ID list, When creating a whole machine image based on an instance, specify the data disk ID contained in the image.
	DataDiskIds pulumi.StringArrayInput
	// Set whether to force shutdown during mirroring. The default value is `false`, when set to true, it means that the mirror will be made after shutdown.
	ForcePoweroff pulumi.BoolPtrInput
	// Image Description.
	ImageDescription pulumi.StringPtrInput
	// Image name.
	ImageName pulumi.StringInput
	// Cloud server instance ID.
	InstanceId pulumi.StringPtrInput
	// Cloud disk snapshot ID list; creating a mirror based on a snapshot must include a system disk snapshot. It cannot be passed in simultaneously with InstanceId.
	SnapshotIds pulumi.StringArrayInput
	// Sysprep function under Windows. When creating a Windows image, you can select true or false to enable or disable the Syspre function.
	Sysprep pulumi.BoolPtrInput
	// Tags of the image.
	Tags pulumi.MapInput
}

The set of arguments for constructing a Instance resource.

func (InstanceArgs) ElementType 

func (InstanceArgs) ElementType() reflect.Type

type InstanceArray 

type InstanceArray []InstanceInput

func (InstanceArray) ElementType 

func (InstanceArray) ElementType() reflect.Type

func (InstanceArray) ToInstanceArrayOutput 

func (i InstanceArray) ToInstanceArrayOutput() InstanceArrayOutput

func (InstanceArray) ToInstanceArrayOutputWithContext 

func (i InstanceArray) ToInstanceArrayOutputWithContext(ctx context.Context) InstanceArrayOutput

type InstanceArrayInput 

type InstanceArrayInput interface {
	pulumi.Input

	ToInstanceArrayOutput() InstanceArrayOutput
	ToInstanceArrayOutputWithContext(context.Context) InstanceArrayOutput
}

InstanceArrayInput is an input type that accepts InstanceArray and InstanceArrayOutput values. You can construct a concrete instance of `InstanceArrayInput` via: 

InstanceArray{ InstanceArgs{...} }

type InstanceArrayOutput 

type InstanceArrayOutput struct{ *pulumi.OutputState }

func (InstanceArrayOutput) ElementType 

func (InstanceArrayOutput) ElementType() reflect.Type

func (InstanceArrayOutput) Index 

func (o InstanceArrayOutput) Index(i pulumi.IntInput) InstanceOutput

func (InstanceArrayOutput) ToInstanceArrayOutput 

func (o InstanceArrayOutput) ToInstanceArrayOutput() InstanceArrayOutput

func (InstanceArrayOutput) ToInstanceArrayOutputWithContext 

func (o InstanceArrayOutput) ToInstanceArrayOutputWithContext(ctx context.Context) InstanceArrayOutput

type InstanceInput 

type InstanceInput interface {
	pulumi.Input

	ToInstanceOutput() InstanceOutput
	ToInstanceOutputWithContext(ctx context.Context) InstanceOutput
}

type InstanceMap 

type InstanceMap map[string]InstanceInput

func (InstanceMap) ElementType 

func (InstanceMap) ElementType() reflect.Type

func (InstanceMap) ToInstanceMapOutput 

func (i InstanceMap) ToInstanceMapOutput() InstanceMapOutput

func (InstanceMap) ToInstanceMapOutputWithContext 

func (i InstanceMap) ToInstanceMapOutputWithContext(ctx context.Context) InstanceMapOutput

type InstanceMapInput 

type InstanceMapInput interface {
	pulumi.Input

	ToInstanceMapOutput() InstanceMapOutput
	ToInstanceMapOutputWithContext(context.Context) InstanceMapOutput
}

InstanceMapInput is an input type that accepts InstanceMap and InstanceMapOutput values. You can construct a concrete instance of `InstanceMapInput` via: 

InstanceMap{ "key": InstanceArgs{...} }

type InstanceMapOutput 

type InstanceMapOutput struct{ *pulumi.OutputState }

func (InstanceMapOutput) ElementType 

func (InstanceMapOutput) ElementType() reflect.Type

func (InstanceMapOutput) MapIndex 

func (o InstanceMapOutput) MapIndex(k pulumi.StringInput) InstanceOutput

func (InstanceMapOutput) ToInstanceMapOutput 

func (o InstanceMapOutput) ToInstanceMapOutput() InstanceMapOutput

func (InstanceMapOutput) ToInstanceMapOutputWithContext 

func (o InstanceMapOutput) ToInstanceMapOutputWithContext(ctx context.Context) InstanceMapOutput

type InstanceOutput 

type InstanceOutput struct{ *pulumi.OutputState }

func (InstanceOutput) DataDiskIds 

func (o InstanceOutput) DataDiskIds() pulumi.StringArrayOutput

Cloud disk ID list, When creating a whole machine image based on an instance, specify the data disk ID contained in the image.

func (InstanceOutput) ElementType 

func (InstanceOutput) ElementType() reflect.Type

func (InstanceOutput) ForcePoweroff 

func (o InstanceOutput) ForcePoweroff() pulumi.BoolPtrOutput

Set whether to force shutdown during mirroring. The default value is `false`, when set to true, it means that the mirror will be made after shutdown.

func (InstanceOutput) ImageDescription 

func (o InstanceOutput) ImageDescription() pulumi.StringPtrOutput

Image Description.

func (InstanceOutput) ImageName 

func (o InstanceOutput) ImageName() pulumi.StringOutput

Image name.

func (InstanceOutput) InstanceId 

func (o InstanceOutput) InstanceId() pulumi.StringPtrOutput

Cloud server instance ID.

func (InstanceOutput) SnapshotIds 

func (o InstanceOutput) SnapshotIds() pulumi.StringArrayOutput

Cloud disk snapshot ID list; creating a mirror based on a snapshot must include a system disk snapshot. It cannot be passed in simultaneously with InstanceId.

func (InstanceOutput) Sysprep 

func (o InstanceOutput) Sysprep() pulumi.BoolPtrOutput

Sysprep function under Windows. When creating a Windows image, you can select true or false to enable or disable the Syspre function.

func (InstanceOutput) Tags added in v0.1.3 

func (o InstanceOutput) Tags() pulumi.MapOutput

Tags of the image.

func (InstanceOutput) ToInstanceOutput 

func (o InstanceOutput) ToInstanceOutput() InstanceOutput

func (InstanceOutput) ToInstanceOutputWithContext 

func (o InstanceOutput) ToInstanceOutputWithContext(ctx context.Context) InstanceOutput

type InstanceState 

type InstanceState struct {
	// Cloud disk ID list, When creating a whole machine image based on an instance, specify the data disk ID contained in the image.
	DataDiskIds pulumi.StringArrayInput
	// Set whether to force shutdown during mirroring. The default value is `false`, when set to true, it means that the mirror will be made after shutdown.
	ForcePoweroff pulumi.BoolPtrInput
	// Image Description.
	ImageDescription pulumi.StringPtrInput
	// Image name.
	ImageName pulumi.StringPtrInput
	// Cloud server instance ID.
	InstanceId pulumi.StringPtrInput
	// Cloud disk snapshot ID list; creating a mirror based on a snapshot must include a system disk snapshot. It cannot be passed in simultaneously with InstanceId.
	SnapshotIds pulumi.StringArrayInput
	// Sysprep function under Windows. When creating a Windows image, you can select true or false to enable or disable the Syspre function.
	Sysprep pulumi.BoolPtrInput
	// Tags of the image.
	Tags pulumi.MapInput
}

func (InstanceState) ElementType 

func (InstanceState) ElementType() reflect.Type

type LookupInstanceArgs 

type LookupInstanceArgs struct {
	// One or more name/value pairs to filter.
	Filters []GetInstanceFilter `pulumi:"filters"`
	// A regex string to apply to the image list returned by TencentCloud. **NOTE**: it is not wildcard, should look like `imageNameRegex = "^CentOS\s+6\.8\s+64\w*"`.
	ImageNameRegex *string `pulumi:"imageNameRegex"`
	// A string to apply with fuzzy match to the osName attribute on the image list returned by TencentCloud. **NOTE**: when osName is provided, highest priority is applied in this field instead of `imageNameRegex`.
	OsName *string `pulumi:"osName"`
	// Used to save results.
	ResultOutputFile *string `pulumi:"resultOutputFile"`
}

A collection of arguments for invoking getInstance.

type LookupInstanceOutputArgs 

type LookupInstanceOutputArgs struct {
	// One or more name/value pairs to filter.
	Filters GetInstanceFilterArrayInput `pulumi:"filters"`
	// A regex string to apply to the image list returned by TencentCloud. **NOTE**: it is not wildcard, should look like `imageNameRegex = "^CentOS\s+6\.8\s+64\w*"`.
	ImageNameRegex pulumi.StringPtrInput `pulumi:"imageNameRegex"`
	// A string to apply with fuzzy match to the osName attribute on the image list returned by TencentCloud. **NOTE**: when osName is provided, highest priority is applied in this field instead of `imageNameRegex`.
	OsName pulumi.StringPtrInput `pulumi:"osName"`
	// Used to save results.
	ResultOutputFile pulumi.StringPtrInput `pulumi:"resultOutputFile"`
}

A collection of arguments for invoking getInstance.

func (LookupInstanceOutputArgs) ElementType 

func (LookupInstanceOutputArgs) ElementType() reflect.Type

type LookupInstanceResult 

type LookupInstanceResult struct {
	Filters []GetInstanceFilter `pulumi:"filters"`
	// The provider-assigned unique ID for this managed resource.
	Id string `pulumi:"id"`
	// An image id indicate the uniqueness of a certain image,  which can be used for instance creation or resetting.
	ImageId string `pulumi:"imageId"`
	// Name of this image.
	ImageName        string  `pulumi:"imageName"`
	ImageNameRegex   *string `pulumi:"imageNameRegex"`
	OsName           *string `pulumi:"osName"`
	ResultOutputFile *string `pulumi:"resultOutputFile"`
}

A collection of values returned by getInstance.

func LookupInstance 

func LookupInstance(ctx *pulumi.Context, args *LookupInstanceArgs, opts ...pulumi.InvokeOption) (*LookupInstanceResult, error)

Provides an available image for the user.

The Images data source fetch proper image, which could be one of the private images of the user and images of system resources provided by TencentCloud, as well as other public images and those available on the image market.

> **NOTE:** This data source will be deprecated, please use `Images.getInstance` instead.

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-tencentcloud/sdk/go/tencentcloud/Image"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/tencentcloudstack/pulumi-tencentcloud/sdk/go/tencentcloud/Image"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Image.GetInstance(ctx, &image.GetInstanceArgs{
			Filters: []image.GetInstanceFilter{
				image.GetInstanceFilter{
					Name: "image-type",
					Values: []string{
						"PUBLIC_IMAGE",
					},
				},
			},
			OsName: pulumi.StringRef("centos"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

```

type LookupInstanceResultOutput 

type LookupInstanceResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getInstance.

func LookupInstanceOutput 

func LookupInstanceOutput(ctx *pulumi.Context, args LookupInstanceOutputArgs, opts ...pulumi.InvokeOption) LookupInstanceResultOutput

func (LookupInstanceResultOutput) ElementType 

func (LookupInstanceResultOutput) ElementType() reflect.Type

func (LookupInstanceResultOutput) Filters 

func (o LookupInstanceResultOutput) Filters() GetInstanceFilterArrayOutput

func (LookupInstanceResultOutput) Id 

func (o LookupInstanceResultOutput) Id() pulumi.StringOutput

The provider-assigned unique ID for this managed resource.

func (LookupInstanceResultOutput) ImageId 

func (o LookupInstanceResultOutput) ImageId() pulumi.StringOutput

An image id indicate the uniqueness of a certain image, which can be used for instance creation or resetting.

func (LookupInstanceResultOutput) ImageName 

func (o LookupInstanceResultOutput) ImageName() pulumi.StringOutput

Name of this image.

func (LookupInstanceResultOutput) ImageNameRegex 

func (o LookupInstanceResultOutput) ImageNameRegex() pulumi.StringPtrOutput

func (LookupInstanceResultOutput) OsName 

func (o LookupInstanceResultOutput) OsName() pulumi.StringPtrOutput

func (LookupInstanceResultOutput) ResultOutputFile 

func (o LookupInstanceResultOutput) ResultOutputFile() pulumi.StringPtrOutput

func (LookupInstanceResultOutput) ToLookupInstanceResultOutput 

func (o LookupInstanceResultOutput) ToLookupInstanceResultOutput() LookupInstanceResultOutput

func (LookupInstanceResultOutput) ToLookupInstanceResultOutputWithContext 

func (o LookupInstanceResultOutput) ToLookupInstanceResultOutputWithContext(ctx context.Context) LookupInstanceResultOutput

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.