vra 0.12.0 published on Monday, Apr 14, 2025 by vmware
vra.getImageProfile
Explore with Pulumi AI
Example Usage
S
This is an example of how to read an image profile as data source.
Image profile data source by its id:
import * as pulumi from "@pulumi/pulumi";
import * as vra from "@pulumi/vra";
const _this = vra.getImageProfile({
    filter: "name eq 'foobar'",
});
import pulumi
import pulumi_vra as vra
this = vra.get_image_profile(filter="name eq 'foobar'")
package main
import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/vra/vra"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vra.LookupImageProfile(ctx, &vra.LookupImageProfileArgs{
			Filter: pulumi.StringRef("name eq 'foobar'"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Vra = Pulumi.Vra;
return await Deployment.RunAsync(() => 
{
    var @this = Vra.GetImageProfile.Invoke(new()
    {
        Filter = "name eq 'foobar'",
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vra.VraFunctions;
import com.pulumi.vra.inputs.GetImageProfileArgs;
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) {
        final var this = VraFunctions.getImageProfile(GetImageProfileArgs.builder()
            .filter("name eq 'foobar'")
            .build());
    }
}
variables:
  this:
    fn::invoke:
      function: vra:getImageProfile
      arguments:
        filter: name eq 'foobar'
Vra image profile data source filter by region id:
import * as pulumi from "@pulumi/pulumi";
import * as vra from "@pulumi/vra";
const _this = vra.getImageProfile({
    regionId: vra_image_profile["this"].region_id,
});
import pulumi
import pulumi_vra as vra
this = vra.get_image_profile(region_id=vra_image_profile["this"]["region_id"])
package main
import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/vra/vra"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vra.LookupImageProfile(ctx, &vra.LookupImageProfileArgs{
			RegionId: pulumi.StringRef(vra_image_profile.This.Region_id),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Vra = Pulumi.Vra;
return await Deployment.RunAsync(() => 
{
    var @this = Vra.GetImageProfile.Invoke(new()
    {
        RegionId = vra_image_profile.This.Region_id,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vra.VraFunctions;
import com.pulumi.vra.inputs.GetImageProfileArgs;
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) {
        final var this = VraFunctions.getImageProfile(GetImageProfileArgs.builder()
            .regionId(vra_image_profile.this().region_id())
            .build());
    }
}
variables:
  this:
    fn::invoke:
      function: vra:getImageProfile
      arguments:
        regionId: ${vra_image_profile.this.region_id}
An image profile data source supports the following arguments:
Using getImageProfile
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 getImageProfile(args: GetImageProfileArgs, opts?: InvokeOptions): Promise<GetImageProfileResult>
function getImageProfileOutput(args: GetImageProfileOutputArgs, opts?: InvokeOptions): Output<GetImageProfileResult>def get_image_profile(description: Optional[str] = None,
                      filter: Optional[str] = None,
                      id: Optional[str] = None,
                      image_mappings: Optional[Sequence[GetImageProfileImageMapping]] = None,
                      name: Optional[str] = None,
                      region_id: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetImageProfileResult
def get_image_profile_output(description: Optional[pulumi.Input[str]] = None,
                      filter: Optional[pulumi.Input[str]] = None,
                      id: Optional[pulumi.Input[str]] = None,
                      image_mappings: Optional[pulumi.Input[Sequence[pulumi.Input[GetImageProfileImageMappingArgs]]]] = None,
                      name: Optional[pulumi.Input[str]] = None,
                      region_id: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetImageProfileResult]func LookupImageProfile(ctx *Context, args *LookupImageProfileArgs, opts ...InvokeOption) (*LookupImageProfileResult, error)
func LookupImageProfileOutput(ctx *Context, args *LookupImageProfileOutputArgs, opts ...InvokeOption) LookupImageProfileResultOutput> Note: This function is named LookupImageProfile in the Go SDK.
public static class GetImageProfile 
{
    public static Task<GetImageProfileResult> InvokeAsync(GetImageProfileArgs args, InvokeOptions? opts = null)
    public static Output<GetImageProfileResult> Invoke(GetImageProfileInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetImageProfileResult> getImageProfile(GetImageProfileArgs args, InvokeOptions options)
public static Output<GetImageProfileResult> getImageProfile(GetImageProfileArgs args, InvokeOptions options)
fn::invoke:
  function: vra:index/getImageProfile:getImageProfile
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Description string
 - A human-friendly description.
 - Filter string
 - Filter query string that is supported by vRA multi-cloud IaaS API. Example: 
regionId eq '<regionId>' and cloudAccountId eq '<cloudAccountId>'. - Id string
 - The id of the image profile instance.
 - Image
Mappings List<GetImage Profile Image Mapping>  - Image mapping defined for the corresponding region.
 - Name string
 - A human-friendly name used as an identifier in APIs that support this option.
 - Region
Id string - The id of the region for which this profile is defined as in vRealize Automation(vRA).
 
- Description string
 - A human-friendly description.
 - Filter string
 - Filter query string that is supported by vRA multi-cloud IaaS API. Example: 
regionId eq '<regionId>' and cloudAccountId eq '<cloudAccountId>'. - Id string
 - The id of the image profile instance.
 - Image
Mappings []GetImage Profile Image Mapping  - Image mapping defined for the corresponding region.
 - Name string
 - A human-friendly name used as an identifier in APIs that support this option.
 - Region
Id string - The id of the region for which this profile is defined as in vRealize Automation(vRA).
 
- description String
 - A human-friendly description.
 - filter String
 - Filter query string that is supported by vRA multi-cloud IaaS API. Example: 
regionId eq '<regionId>' and cloudAccountId eq '<cloudAccountId>'. - id String
 - The id of the image profile instance.
 - image
Mappings List<GetImage Profile Image Mapping>  - Image mapping defined for the corresponding region.
 - name String
 - A human-friendly name used as an identifier in APIs that support this option.
 - region
Id String - The id of the region for which this profile is defined as in vRealize Automation(vRA).
 
- description string
 - A human-friendly description.
 - filter string
 - Filter query string that is supported by vRA multi-cloud IaaS API. Example: 
regionId eq '<regionId>' and cloudAccountId eq '<cloudAccountId>'. - id string
 - The id of the image profile instance.
 - image
Mappings GetImage Profile Image Mapping[]  - Image mapping defined for the corresponding region.
 - name string
 - A human-friendly name used as an identifier in APIs that support this option.
 - region
Id string - The id of the region for which this profile is defined as in vRealize Automation(vRA).
 
- description str
 - A human-friendly description.
 - filter str
 - Filter query string that is supported by vRA multi-cloud IaaS API. Example: 
regionId eq '<regionId>' and cloudAccountId eq '<cloudAccountId>'. - id str
 - The id of the image profile instance.
 - image_
mappings Sequence[GetImage Profile Image Mapping]  - Image mapping defined for the corresponding region.
 - name str
 - A human-friendly name used as an identifier in APIs that support this option.
 - region_
id str - The id of the region for which this profile is defined as in vRealize Automation(vRA).
 
- description String
 - A human-friendly description.
 - filter String
 - Filter query string that is supported by vRA multi-cloud IaaS API. Example: 
regionId eq '<regionId>' and cloudAccountId eq '<cloudAccountId>'. - id String
 - The id of the image profile instance.
 - image
Mappings List<Property Map> - Image mapping defined for the corresponding region.
 - name String
 - A human-friendly name used as an identifier in APIs that support this option.
 - region
Id String - The id of the region for which this profile is defined as in vRealize Automation(vRA).
 
getImageProfile Result
The following output properties are available:
- Created
At string - Date when the entity was created. The date is in ISO 6801 and UTC.
 - External
Region stringId  - The external regionId of the resource.
 - Id string
 - Name string
 - Owner string
 - Email of the user that owns the entity.
 - Region
Id string - Updated
At string - Date when the entity was last updated. The date is ISO 8601 and UTC.
 - Description string
 - A human-friendly description.
 - Filter string
 - Image
Mappings List<GetImage Profile Image Mapping>  - Image mapping defined for the corresponding region.
 
- Created
At string - Date when the entity was created. The date is in ISO 6801 and UTC.
 - External
Region stringId  - The external regionId of the resource.
 - Id string
 - Name string
 - Owner string
 - Email of the user that owns the entity.
 - Region
Id string - Updated
At string - Date when the entity was last updated. The date is ISO 8601 and UTC.
 - Description string
 - A human-friendly description.
 - Filter string
 - Image
Mappings []GetImage Profile Image Mapping  - Image mapping defined for the corresponding region.
 
- created
At String - Date when the entity was created. The date is in ISO 6801 and UTC.
 - external
Region StringId  - The external regionId of the resource.
 - id String
 - name String
 - owner String
 - Email of the user that owns the entity.
 - region
Id String - updated
At String - Date when the entity was last updated. The date is ISO 8601 and UTC.
 - description String
 - A human-friendly description.
 - filter String
 - image
Mappings List<GetImage Profile Image Mapping>  - Image mapping defined for the corresponding region.
 
- created
At string - Date when the entity was created. The date is in ISO 6801 and UTC.
 - external
Region stringId  - The external regionId of the resource.
 - id string
 - name string
 - owner string
 - Email of the user that owns the entity.
 - region
Id string - updated
At string - Date when the entity was last updated. The date is ISO 8601 and UTC.
 - description string
 - A human-friendly description.
 - filter string
 - image
Mappings GetImage Profile Image Mapping[]  - Image mapping defined for the corresponding region.
 
- created_
at str - Date when the entity was created. The date is in ISO 6801 and UTC.
 - external_
region_ strid  - The external regionId of the resource.
 - id str
 - name str
 - owner str
 - Email of the user that owns the entity.
 - region_
id str - updated_
at str - Date when the entity was last updated. The date is ISO 8601 and UTC.
 - description str
 - A human-friendly description.
 - filter str
 - image_
mappings Sequence[GetImage Profile Image Mapping]  - Image mapping defined for the corresponding region.
 
- created
At String - Date when the entity was created. The date is in ISO 6801 and UTC.
 - external
Region StringId  - The external regionId of the resource.
 - id String
 - name String
 - owner String
 - Email of the user that owns the entity.
 - region
Id String - updated
At String - Date when the entity was last updated. The date is ISO 8601 and UTC.
 - description String
 - A human-friendly description.
 - filter String
 - image
Mappings List<Property Map> - Image mapping defined for the corresponding region.
 
Supporting Types
GetImageProfileImageMapping    
- Description string
 - A human-friendly description.
 - External
Id string - External entity id on the cloud provider side.
 - External
Region stringId  - The external regionId of the resource.
 - Name string
 - A human-friendly name used as an identifier in APIs that support this option.
 - Organization string
 - A human-friendly description.
 - Os
Family string - Operating system family of the image.
 - Owner string
 - Email of the user that owns the entity.
 - Private bool
 - Indicates whether this fabric image is private. For vSphere, private images are considered to be templates and snapshots and public are Content Library items.
 - Cloud
Config string - Cloud config for this image. This cloud config will be merged during provisioning with other cloud configurations such as the bootConfig provided in MachineSpecification or vRA cloud templates.
 - Constraints
List<Get
Image Profile Image Mapping Constraint>  - Constraints that are used to drive placement policies for entities such as image, network, storage, etc. Constraint expressions are matched against tags on existing placement targets.
 - Image
Id string - The id of this resource instance.
 - Image
Name string - A human-friendly image name as seen on the cloud provider side.
 
- Description string
 - A human-friendly description.
 - External
Id string - External entity id on the cloud provider side.
 - External
Region stringId  - The external regionId of the resource.
 - Name string
 - A human-friendly name used as an identifier in APIs that support this option.
 - Organization string
 - A human-friendly description.
 - Os
Family string - Operating system family of the image.
 - Owner string
 - Email of the user that owns the entity.
 - Private bool
 - Indicates whether this fabric image is private. For vSphere, private images are considered to be templates and snapshots and public are Content Library items.
 - Cloud
Config string - Cloud config for this image. This cloud config will be merged during provisioning with other cloud configurations such as the bootConfig provided in MachineSpecification or vRA cloud templates.
 - Constraints
[]Get
Image Profile Image Mapping Constraint  - Constraints that are used to drive placement policies for entities such as image, network, storage, etc. Constraint expressions are matched against tags on existing placement targets.
 - Image
Id string - The id of this resource instance.
 - Image
Name string - A human-friendly image name as seen on the cloud provider side.
 
- description String
 - A human-friendly description.
 - external
Id String - External entity id on the cloud provider side.
 - external
Region StringId  - The external regionId of the resource.
 - name String
 - A human-friendly name used as an identifier in APIs that support this option.
 - organization String
 - A human-friendly description.
 - os
Family String - Operating system family of the image.
 - owner String
 - Email of the user that owns the entity.
 - private_ Boolean
 - Indicates whether this fabric image is private. For vSphere, private images are considered to be templates and snapshots and public are Content Library items.
 - cloud
Config String - Cloud config for this image. This cloud config will be merged during provisioning with other cloud configurations such as the bootConfig provided in MachineSpecification or vRA cloud templates.
 - constraints
List<Get
Image Profile Image Mapping Constraint>  - Constraints that are used to drive placement policies for entities such as image, network, storage, etc. Constraint expressions are matched against tags on existing placement targets.
 - image
Id String - The id of this resource instance.
 - image
Name String - A human-friendly image name as seen on the cloud provider side.
 
- description string
 - A human-friendly description.
 - external
Id string - External entity id on the cloud provider side.
 - external
Region stringId  - The external regionId of the resource.
 - name string
 - A human-friendly name used as an identifier in APIs that support this option.
 - organization string
 - A human-friendly description.
 - os
Family string - Operating system family of the image.
 - owner string
 - Email of the user that owns the entity.
 - private boolean
 - Indicates whether this fabric image is private. For vSphere, private images are considered to be templates and snapshots and public are Content Library items.
 - cloud
Config string - Cloud config for this image. This cloud config will be merged during provisioning with other cloud configurations such as the bootConfig provided in MachineSpecification or vRA cloud templates.
 - constraints
Get
Image Profile Image Mapping Constraint[]  - Constraints that are used to drive placement policies for entities such as image, network, storage, etc. Constraint expressions are matched against tags on existing placement targets.
 - image
Id string - The id of this resource instance.
 - image
Name string - A human-friendly image name as seen on the cloud provider side.
 
- description str
 - A human-friendly description.
 - external_
id str - External entity id on the cloud provider side.
 - external_
region_ strid  - The external regionId of the resource.
 - name str
 - A human-friendly name used as an identifier in APIs that support this option.
 - organization str
 - A human-friendly description.
 - os_
family str - Operating system family of the image.
 - owner str
 - Email of the user that owns the entity.
 - private bool
 - Indicates whether this fabric image is private. For vSphere, private images are considered to be templates and snapshots and public are Content Library items.
 - cloud_
config str - Cloud config for this image. This cloud config will be merged during provisioning with other cloud configurations such as the bootConfig provided in MachineSpecification or vRA cloud templates.
 - constraints
Sequence[Get
Image Profile Image Mapping Constraint]  - Constraints that are used to drive placement policies for entities such as image, network, storage, etc. Constraint expressions are matched against tags on existing placement targets.
 - image_
id str - The id of this resource instance.
 - image_
name str - A human-friendly image name as seen on the cloud provider side.
 
- description String
 - A human-friendly description.
 - external
Id String - External entity id on the cloud provider side.
 - external
Region StringId  - The external regionId of the resource.
 - name String
 - A human-friendly name used as an identifier in APIs that support this option.
 - organization String
 - A human-friendly description.
 - os
Family String - Operating system family of the image.
 - owner String
 - Email of the user that owns the entity.
 - private Boolean
 - Indicates whether this fabric image is private. For vSphere, private images are considered to be templates and snapshots and public are Content Library items.
 - cloud
Config String - Cloud config for this image. This cloud config will be merged during provisioning with other cloud configurations such as the bootConfig provided in MachineSpecification or vRA cloud templates.
 - constraints List<Property Map>
 - Constraints that are used to drive placement policies for entities such as image, network, storage, etc. Constraint expressions are matched against tags on existing placement targets.
 - image
Id String - The id of this resource instance.
 - image
Name String - A human-friendly image name as seen on the cloud provider side.
 
GetImageProfileImageMappingConstraint     
- Expression string
 - An expression of the form "[!]tag-key[:[tag-value]]", used to indicate a constraint match on keys and values of tags.
 - Mandatory bool
 - Indicates whether this constraint should be strictly enforced or not.
 
- Expression string
 - An expression of the form "[!]tag-key[:[tag-value]]", used to indicate a constraint match on keys and values of tags.
 - Mandatory bool
 - Indicates whether this constraint should be strictly enforced or not.
 
- expression String
 - An expression of the form "[!]tag-key[:[tag-value]]", used to indicate a constraint match on keys and values of tags.
 - mandatory Boolean
 - Indicates whether this constraint should be strictly enforced or not.
 
- expression string
 - An expression of the form "[!]tag-key[:[tag-value]]", used to indicate a constraint match on keys and values of tags.
 - mandatory boolean
 - Indicates whether this constraint should be strictly enforced or not.
 
- expression str
 - An expression of the form "[!]tag-key[:[tag-value]]", used to indicate a constraint match on keys and values of tags.
 - mandatory bool
 - Indicates whether this constraint should be strictly enforced or not.
 
- expression String
 - An expression of the form "[!]tag-key[:[tag-value]]", used to indicate a constraint match on keys and values of tags.
 - mandatory Boolean
 - Indicates whether this constraint should be strictly enforced or not.
 
Package Details
- Repository
 - vra vmware/terraform-provider-vra
 - License
 - Notes
 - This Pulumi package is based on the 
vraTerraform Provider.