Civo v2.3.18 published on Tuesday, Jun 11, 2024 by Pulumi
civo.getDiskImage
Explore with Pulumi AI
Get information on an disk image for use in other resources (e.g. creating a instance) with the ability to filter the results.
Using getDiskImage
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getDiskImage(args: GetDiskImageArgs, opts?: InvokeOptions): Promise<GetDiskImageResult>
function getDiskImageOutput(args: GetDiskImageOutputArgs, opts?: InvokeOptions): Output<GetDiskImageResult>
def get_disk_image(filters: Optional[Sequence[GetDiskImageFilter]] = None,
region: Optional[str] = None,
sorts: Optional[Sequence[GetDiskImageSort]] = None,
opts: Optional[InvokeOptions] = None) -> GetDiskImageResult
def get_disk_image_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetDiskImageFilterArgs]]]] = None,
region: Optional[pulumi.Input[str]] = None,
sorts: Optional[pulumi.Input[Sequence[pulumi.Input[GetDiskImageSortArgs]]]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetDiskImageResult]
func GetDiskImage(ctx *Context, args *GetDiskImageArgs, opts ...InvokeOption) (*GetDiskImageResult, error)
func GetDiskImageOutput(ctx *Context, args *GetDiskImageOutputArgs, opts ...InvokeOption) GetDiskImageResultOutput
> Note: This function is named GetDiskImage
in the Go SDK.
public static class GetDiskImage
{
public static Task<GetDiskImageResult> InvokeAsync(GetDiskImageArgs args, InvokeOptions? opts = null)
public static Output<GetDiskImageResult> Invoke(GetDiskImageInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetDiskImageResult> getDiskImage(GetDiskImageArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: civo:index/getDiskImage:getDiskImage
arguments:
# arguments dictionary
The following arguments are supported:
- Filters
List<Get
Disk Image Filter> - One or more key/value pairs on which to filter results
- Region string
- If is used, all disk image will be from this region. Required if no region is set in provider.
- Sorts
List<Get
Disk Image Sort> - One or more key/direction pairs on which to sort results
- Filters
[]Get
Disk Image Filter - One or more key/value pairs on which to filter results
- Region string
- If is used, all disk image will be from this region. Required if no region is set in provider.
- Sorts
[]Get
Disk Image Sort - One or more key/direction pairs on which to sort results
- filters
List<Get
Disk Image Filter> - One or more key/value pairs on which to filter results
- region String
- If is used, all disk image will be from this region. Required if no region is set in provider.
- sorts
List<Get
Disk Image Sort> - One or more key/direction pairs on which to sort results
- filters
Get
Disk Image Filter[] - One or more key/value pairs on which to filter results
- region string
- If is used, all disk image will be from this region. Required if no region is set in provider.
- sorts
Get
Disk Image Sort[] - One or more key/direction pairs on which to sort results
- filters
Sequence[Get
Disk Image Filter] - One or more key/value pairs on which to filter results
- region str
- If is used, all disk image will be from this region. Required if no region is set in provider.
- sorts
Sequence[Get
Disk Image Sort] - One or more key/direction pairs on which to sort results
- filters List<Property Map>
- One or more key/value pairs on which to filter results
- region String
- If is used, all disk image will be from this region. Required if no region is set in provider.
- sorts List<Property Map>
- One or more key/direction pairs on which to sort results
getDiskImage Result
The following output properties are available:
- Diskimages
List<Get
Disk Image Diskimage> - Id string
- The provider-assigned unique ID for this managed resource.
- Filters
List<Get
Disk Image Filter> - One or more key/value pairs on which to filter results
- Region string
- If is used, all disk image will be from this region. Required if no region is set in provider.
- Sorts
List<Get
Disk Image Sort> - One or more key/direction pairs on which to sort results
- Diskimages
[]Get
Disk Image Diskimage - Id string
- The provider-assigned unique ID for this managed resource.
- Filters
[]Get
Disk Image Filter - One or more key/value pairs on which to filter results
- Region string
- If is used, all disk image will be from this region. Required if no region is set in provider.
- Sorts
[]Get
Disk Image Sort - One or more key/direction pairs on which to sort results
- diskimages
List<Get
Disk Image Diskimage> - id String
- The provider-assigned unique ID for this managed resource.
- filters
List<Get
Disk Image Filter> - One or more key/value pairs on which to filter results
- region String
- If is used, all disk image will be from this region. Required if no region is set in provider.
- sorts
List<Get
Disk Image Sort> - One or more key/direction pairs on which to sort results
- diskimages
Get
Disk Image Diskimage[] - id string
- The provider-assigned unique ID for this managed resource.
- filters
Get
Disk Image Filter[] - One or more key/value pairs on which to filter results
- region string
- If is used, all disk image will be from this region. Required if no region is set in provider.
- sorts
Get
Disk Image Sort[] - One or more key/direction pairs on which to sort results
- diskimages
Sequence[Get
Disk Image Diskimage] - id str
- The provider-assigned unique ID for this managed resource.
- filters
Sequence[Get
Disk Image Filter] - One or more key/value pairs on which to filter results
- region str
- If is used, all disk image will be from this region. Required if no region is set in provider.
- sorts
Sequence[Get
Disk Image Sort] - One or more key/direction pairs on which to sort results
- diskimages List<Property Map>
- id String
- The provider-assigned unique ID for this managed resource.
- filters List<Property Map>
- One or more key/value pairs on which to filter results
- region String
- If is used, all disk image will be from this region. Required if no region is set in provider.
- sorts List<Property Map>
- One or more key/direction pairs on which to sort results
Supporting Types
GetDiskImageDiskimage
GetDiskImageFilter
- Key string
- Filter diskimages by this key. This may be one of
id
,label
,name
,version
. - Values List<string>
- Only retrieves
diskimages
which keys has value that matches one of the values provided here - All bool
- Set to
true
to require that a field match all of thevalues
instead of just one or more of them. This is useful when matching against multi-valued fields such as lists or sets where you want to ensure that all of thevalues
are present in the list or set. - Match
By string - One of
exact
(default),re
, orsubstring
. For string-typed fields, specifyre
to match by using thevalues
as regular expressions, or specifysubstring
to match by treating thevalues
as substrings to find within the string field.
- Key string
- Filter diskimages by this key. This may be one of
id
,label
,name
,version
. - Values []string
- Only retrieves
diskimages
which keys has value that matches one of the values provided here - All bool
- Set to
true
to require that a field match all of thevalues
instead of just one or more of them. This is useful when matching against multi-valued fields such as lists or sets where you want to ensure that all of thevalues
are present in the list or set. - Match
By string - One of
exact
(default),re
, orsubstring
. For string-typed fields, specifyre
to match by using thevalues
as regular expressions, or specifysubstring
to match by treating thevalues
as substrings to find within the string field.
- key String
- Filter diskimages by this key. This may be one of
id
,label
,name
,version
. - values List<String>
- Only retrieves
diskimages
which keys has value that matches one of the values provided here - all Boolean
- Set to
true
to require that a field match all of thevalues
instead of just one or more of them. This is useful when matching against multi-valued fields such as lists or sets where you want to ensure that all of thevalues
are present in the list or set. - match
By String - One of
exact
(default),re
, orsubstring
. For string-typed fields, specifyre
to match by using thevalues
as regular expressions, or specifysubstring
to match by treating thevalues
as substrings to find within the string field.
- key string
- Filter diskimages by this key. This may be one of
id
,label
,name
,version
. - values string[]
- Only retrieves
diskimages
which keys has value that matches one of the values provided here - all boolean
- Set to
true
to require that a field match all of thevalues
instead of just one or more of them. This is useful when matching against multi-valued fields such as lists or sets where you want to ensure that all of thevalues
are present in the list or set. - match
By string - One of
exact
(default),re
, orsubstring
. For string-typed fields, specifyre
to match by using thevalues
as regular expressions, or specifysubstring
to match by treating thevalues
as substrings to find within the string field.
- key str
- Filter diskimages by this key. This may be one of
id
,label
,name
,version
. - values Sequence[str]
- Only retrieves
diskimages
which keys has value that matches one of the values provided here - all bool
- Set to
true
to require that a field match all of thevalues
instead of just one or more of them. This is useful when matching against multi-valued fields such as lists or sets where you want to ensure that all of thevalues
are present in the list or set. - match_
by str - One of
exact
(default),re
, orsubstring
. For string-typed fields, specifyre
to match by using thevalues
as regular expressions, or specifysubstring
to match by treating thevalues
as substrings to find within the string field.
- key String
- Filter diskimages by this key. This may be one of
id
,label
,name
,version
. - values List<String>
- Only retrieves
diskimages
which keys has value that matches one of the values provided here - all Boolean
- Set to
true
to require that a field match all of thevalues
instead of just one or more of them. This is useful when matching against multi-valued fields such as lists or sets where you want to ensure that all of thevalues
are present in the list or set. - match
By String - One of
exact
(default),re
, orsubstring
. For string-typed fields, specifyre
to match by using thevalues
as regular expressions, or specifysubstring
to match by treating thevalues
as substrings to find within the string field.
GetDiskImageSort
Package Details
- Repository
- Civo pulumi/pulumi-civo
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
civo
Terraform Provider.