Civo v2.3.18 published on Tuesday, Jun 11, 2024 by Pulumi
civo.getRegion
Explore with Pulumi AI
Retrieves information about the region that Civo supports, with the ability to filter the results.
Using getRegion
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 getRegion(args: GetRegionArgs, opts?: InvokeOptions): Promise<GetRegionResult>
function getRegionOutput(args: GetRegionOutputArgs, opts?: InvokeOptions): Output<GetRegionResult>
def get_region(filters: Optional[Sequence[GetRegionFilter]] = None,
sorts: Optional[Sequence[GetRegionSort]] = None,
opts: Optional[InvokeOptions] = None) -> GetRegionResult
def get_region_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetRegionFilterArgs]]]] = None,
sorts: Optional[pulumi.Input[Sequence[pulumi.Input[GetRegionSortArgs]]]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetRegionResult]
func GetRegion(ctx *Context, args *GetRegionArgs, opts ...InvokeOption) (*GetRegionResult, error)
func GetRegionOutput(ctx *Context, args *GetRegionOutputArgs, opts ...InvokeOption) GetRegionResultOutput
> Note: This function is named GetRegion
in the Go SDK.
public static class GetRegion
{
public static Task<GetRegionResult> InvokeAsync(GetRegionArgs args, InvokeOptions? opts = null)
public static Output<GetRegionResult> Invoke(GetRegionInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetRegionResult> getRegion(GetRegionArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: civo:index/getRegion:getRegion
arguments:
# arguments dictionary
The following arguments are supported:
- Filters
List<Get
Region Filter> - One or more key/value pairs on which to filter results
- Sorts
List<Get
Region Sort> - One or more key/direction pairs on which to sort results
- Filters
[]Get
Region Filter - One or more key/value pairs on which to filter results
- Sorts
[]Get
Region Sort - One or more key/direction pairs on which to sort results
- filters
List<Get
Region Filter> - One or more key/value pairs on which to filter results
- sorts
List<Get
Region Sort> - One or more key/direction pairs on which to sort results
- filters
Get
Region Filter[] - One or more key/value pairs on which to filter results
- sorts
Get
Region Sort[] - One or more key/direction pairs on which to sort results
- filters
Sequence[Get
Region Filter] - One or more key/value pairs on which to filter results
- sorts
Sequence[Get
Region 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
- sorts List<Property Map>
- One or more key/direction pairs on which to sort results
getRegion Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Regions
List<Get
Region Region> - Filters
List<Get
Region Filter> - One or more key/value pairs on which to filter results
- Sorts
List<Get
Region Sort> - One or more key/direction pairs on which to sort results
- Id string
- The provider-assigned unique ID for this managed resource.
- Regions
[]Get
Region Region - Filters
[]Get
Region Filter - One or more key/value pairs on which to filter results
- Sorts
[]Get
Region Sort - One or more key/direction pairs on which to sort results
- id String
- The provider-assigned unique ID for this managed resource.
- regions
List<Get
Region Region> - filters
List<Get
Region Filter> - One or more key/value pairs on which to filter results
- sorts
List<Get
Region Sort> - One or more key/direction pairs on which to sort results
- id string
- The provider-assigned unique ID for this managed resource.
- regions
Get
Region Region[] - filters
Get
Region Filter[] - One or more key/value pairs on which to filter results
- sorts
Get
Region Sort[] - One or more key/direction pairs on which to sort results
- id str
- The provider-assigned unique ID for this managed resource.
- regions
Sequence[Get
Region Region] - filters
Sequence[Get
Region Filter] - One or more key/value pairs on which to filter results
- sorts
Sequence[Get
Region Sort] - One or more key/direction pairs on which to sort results
- id String
- The provider-assigned unique ID for this managed resource.
- regions List<Property Map>
- filters List<Property Map>
- One or more key/value pairs on which to filter results
- sorts List<Property Map>
- One or more key/direction pairs on which to sort results
Supporting Types
GetRegionFilter
- Key string
- Filter regions by this key. This may be one of
code
,country
,default
,name
. - Values List<string>
- Only retrieves
regions
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 regions by this key. This may be one of
code
,country
,default
,name
. - Values []string
- Only retrieves
regions
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 regions by this key. This may be one of
code
,country
,default
,name
. - values List<String>
- Only retrieves
regions
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 regions by this key. This may be one of
code
,country
,default
,name
. - values string[]
- Only retrieves
regions
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 regions by this key. This may be one of
code
,country
,default
,name
. - values Sequence[str]
- Only retrieves
regions
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 regions by this key. This may be one of
code
,country
,default
,name
. - values List<String>
- Only retrieves
regions
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.
GetRegionRegion
GetRegionSort
Package Details
- Repository
- Civo pulumi/pulumi-civo
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
civo
Terraform Provider.