Viewing docs for Nutanix v0.16.0
published on Tuesday, May 26, 2026 by Piers Karsenbarg
published on Tuesday, May 26, 2026 by Piers Karsenbarg
Viewing docs for Nutanix v0.16.0
published on Tuesday, May 26, 2026 by Piers Karsenbarg
published on Tuesday, May 26, 2026 by Piers Karsenbarg
Provides a datasource to retrieve an IAM Entity by its external identifier. Entities are used in authorization policies (e.g. user, role, cluster).
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as nutanix from "@pierskarsenbarg/nutanix";
// Get entity by ext_id
const example = nutanix.getIamEntityV2({
extId: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
});
export const entityName = example.then(example => example.name);
import pulumi
import pulumi_nutanix as nutanix
# Get entity by ext_id
example = nutanix.get_iam_entity_v2(ext_id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
pulumi.export("entityName", example.name)
package main
import (
"github.com/pierskarsenbarg/pulumi-nutanix/sdk/go/nutanix"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
// Get entity by ext_id
example, err := nutanix.GetIamEntityV2(ctx, &nutanix.GetIamEntityV2Args{
ExtId: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
}, nil)
if err != nil {
return err
}
ctx.Export("entityName", example.Name)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Nutanix = PiersKarsenbarg.Nutanix;
return await Deployment.RunAsync(() =>
{
// Get entity by ext_id
var example = Nutanix.GetIamEntityV2.Invoke(new()
{
ExtId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
});
return new Dictionary<string, object?>
{
["entityName"] = example.Apply(getIamEntityV2Result => getIamEntityV2Result.Name),
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.nutanix.NutanixFunctions;
import com.pulumi.nutanix.inputs.GetIamEntityV2Args;
import java.util.ArrayList;
import java.util.Arrays;
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) {
// Get entity by ext_id
final var example = NutanixFunctions.getIamEntityV2(GetIamEntityV2Args.builder()
.extId("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
.build());
ctx.export("entityName", example.name());
}
}
variables:
# Get entity by ext_id
example:
fn::invoke:
function: nutanix:getIamEntityV2
arguments:
extId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
outputs:
entityName: ${example.name}
pulumi {
required_providers {
nutanix = {
source = "pulumi/nutanix"
}
}
}
data "nutanix_getiamentityv2" "example" {
ext_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
# Get entity by ext_id
output "entityName" {
value = data.nutanix_getiamentityv2.example.name
}
Using getIamEntityV2
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 getIamEntityV2(args: GetIamEntityV2Args, opts?: InvokeOptions): Promise<GetIamEntityV2Result>
function getIamEntityV2Output(args: GetIamEntityV2OutputArgs, opts?: InvokeOptions): Output<GetIamEntityV2Result>def get_iam_entity_v2(ext_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetIamEntityV2Result
def get_iam_entity_v2_output(ext_id: pulumi.Input[Optional[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetIamEntityV2Result]func GetIamEntityV2(ctx *Context, args *GetIamEntityV2Args, opts ...InvokeOption) (*GetIamEntityV2Result, error)
func GetIamEntityV2Output(ctx *Context, args *GetIamEntityV2OutputArgs, opts ...InvokeOption) GetIamEntityV2ResultOutput> Note: This function is named GetIamEntityV2 in the Go SDK.
public static class GetIamEntityV2
{
public static Task<GetIamEntityV2Result> InvokeAsync(GetIamEntityV2Args args, InvokeOptions? opts = null)
public static Output<GetIamEntityV2Result> Invoke(GetIamEntityV2InvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetIamEntityV2Result> getIamEntityV2(GetIamEntityV2Args args, InvokeOptions options)
public static Output<GetIamEntityV2Result> getIamEntityV2(GetIamEntityV2Args args, InvokeOptions options)
fn::invoke:
function: nutanix:index/getIamEntityV2:getIamEntityV2
arguments:
# arguments dictionarydata "nutanix_getiamentityv2" "name" {
# arguments
}The following arguments are supported:
- Ext
Id string - External identifier of the IAM Entity.
- Ext
Id string - External identifier of the IAM Entity.
- ext_
id string - External identifier of the IAM Entity.
- ext
Id String - External identifier of the IAM Entity.
- ext
Id string - External identifier of the IAM Entity.
- ext_
id str - External identifier of the IAM Entity.
- ext
Id String - External identifier of the IAM Entity.
getIamEntityV2 Result
The following output properties are available:
- Attribute
Lists List<PiersKarsenbarg. Nutanix. Outputs. Get Iam Entity V2Attribute List> - List of attributes for the Entity (used in authorization policy filters).
- Client
Name string - Client that created the entity.
- Created
By string - User or Service that created the Entity.
- Created
Time string - Creation time of the Entity.
- Description string
- Description of the Entity.
- Display
Name string - Display name of the entity's attribute.
- Ext
Id string - External identifier of the attribute.
- Id string
- The provider-assigned unique ID for this managed resource.
- Is
Logical boolAnd Supported For Attributes - Whether logical AND is supported for attributes. Indicates whether the entity supports scoping using multiple attributes which will result in a logical AND.
- Last
Updated stringTime - Last updated time of the Entity.
- Links
List<Piers
Karsenbarg. Nutanix. Outputs. Get Iam Entity V2Link> - HATEOAS links for the attribute (each with
hrefandrel). - Name string
- Name of the entity's attribute used in Authorization Policy filters.
- Search
Url string - Search URL for the Entity. URL provided by the client to search the entities.
- Tenant
Id string - Tenant identifier for the attribute.
- Attribute
Lists []GetIam Entity V2Attribute List - List of attributes for the Entity (used in authorization policy filters).
- Client
Name string - Client that created the entity.
- Created
By string - User or Service that created the Entity.
- Created
Time string - Creation time of the Entity.
- Description string
- Description of the Entity.
- Display
Name string - Display name of the entity's attribute.
- Ext
Id string - External identifier of the attribute.
- Id string
- The provider-assigned unique ID for this managed resource.
- Is
Logical boolAnd Supported For Attributes - Whether logical AND is supported for attributes. Indicates whether the entity supports scoping using multiple attributes which will result in a logical AND.
- Last
Updated stringTime - Last updated time of the Entity.
- Links
[]Get
Iam Entity V2Link - HATEOAS links for the attribute (each with
hrefandrel). - Name string
- Name of the entity's attribute used in Authorization Policy filters.
- Search
Url string - Search URL for the Entity. URL provided by the client to search the entities.
- Tenant
Id string - Tenant identifier for the attribute.
- attribute_
lists list(object) - List of attributes for the Entity (used in authorization policy filters).
- client_
name string - Client that created the entity.
- created_
by string - User or Service that created the Entity.
- created_
time string - Creation time of the Entity.
- description string
- Description of the Entity.
- display_
name string - Display name of the entity's attribute.
- ext_
id string - External identifier of the attribute.
- id string
- The provider-assigned unique ID for this managed resource.
- is_
logical_ booland_ supported_ for_ attributes - Whether logical AND is supported for attributes. Indicates whether the entity supports scoping using multiple attributes which will result in a logical AND.
- last_
updated_ stringtime - Last updated time of the Entity.
- links list(object)
- HATEOAS links for the attribute (each with
hrefandrel). - name string
- Name of the entity's attribute used in Authorization Policy filters.
- search_
url string - Search URL for the Entity. URL provided by the client to search the entities.
- tenant_
id string - Tenant identifier for the attribute.
- attribute
Lists List<GetIam Entity V2Attribute List> - List of attributes for the Entity (used in authorization policy filters).
- client
Name String - Client that created the entity.
- created
By String - User or Service that created the Entity.
- created
Time String - Creation time of the Entity.
- description String
- Description of the Entity.
- display
Name String - Display name of the entity's attribute.
- ext
Id String - External identifier of the attribute.
- id String
- The provider-assigned unique ID for this managed resource.
- is
Logical BooleanAnd Supported For Attributes - Whether logical AND is supported for attributes. Indicates whether the entity supports scoping using multiple attributes which will result in a logical AND.
- last
Updated StringTime - Last updated time of the Entity.
- links
List<Get
Iam Entity V2Link> - HATEOAS links for the attribute (each with
hrefandrel). - name String
- Name of the entity's attribute used in Authorization Policy filters.
- search
Url String - Search URL for the Entity. URL provided by the client to search the entities.
- tenant
Id String - Tenant identifier for the attribute.
- attribute
Lists GetIam Entity V2Attribute List[] - List of attributes for the Entity (used in authorization policy filters).
- client
Name string - Client that created the entity.
- created
By string - User or Service that created the Entity.
- created
Time string - Creation time of the Entity.
- description string
- Description of the Entity.
- display
Name string - Display name of the entity's attribute.
- ext
Id string - External identifier of the attribute.
- id string
- The provider-assigned unique ID for this managed resource.
- is
Logical booleanAnd Supported For Attributes - Whether logical AND is supported for attributes. Indicates whether the entity supports scoping using multiple attributes which will result in a logical AND.
- last
Updated stringTime - Last updated time of the Entity.
- links
Get
Iam Entity V2Link[] - HATEOAS links for the attribute (each with
hrefandrel). - name string
- Name of the entity's attribute used in Authorization Policy filters.
- search
Url string - Search URL for the Entity. URL provided by the client to search the entities.
- tenant
Id string - Tenant identifier for the attribute.
- attribute_
lists Sequence[GetIam Entity V2Attribute List] - List of attributes for the Entity (used in authorization policy filters).
- client_
name str - Client that created the entity.
- created_
by str - User or Service that created the Entity.
- created_
time str - Creation time of the Entity.
- description str
- Description of the Entity.
- display_
name str - Display name of the entity's attribute.
- ext_
id str - External identifier of the attribute.
- id str
- The provider-assigned unique ID for this managed resource.
- is_
logical_ booland_ supported_ for_ attributes - Whether logical AND is supported for attributes. Indicates whether the entity supports scoping using multiple attributes which will result in a logical AND.
- last_
updated_ strtime - Last updated time of the Entity.
- links
Sequence[Get
Iam Entity V2Link] - HATEOAS links for the attribute (each with
hrefandrel). - name str
- Name of the entity's attribute used in Authorization Policy filters.
- search_
url str - Search URL for the Entity. URL provided by the client to search the entities.
- tenant_
id str - Tenant identifier for the attribute.
- attribute
Lists List<Property Map> - List of attributes for the Entity (used in authorization policy filters).
- client
Name String - Client that created the entity.
- created
By String - User or Service that created the Entity.
- created
Time String - Creation time of the Entity.
- description String
- Description of the Entity.
- display
Name String - Display name of the entity's attribute.
- ext
Id String - External identifier of the attribute.
- id String
- The provider-assigned unique ID for this managed resource.
- is
Logical BooleanAnd Supported For Attributes - Whether logical AND is supported for attributes. Indicates whether the entity supports scoping using multiple attributes which will result in a logical AND.
- last
Updated StringTime - Last updated time of the Entity.
- links List<Property Map>
- HATEOAS links for the attribute (each with
hrefandrel). - name String
- Name of the entity's attribute used in Authorization Policy filters.
- search
Url String - Search URL for the Entity. URL provided by the client to search the entities.
- tenant
Id String - Tenant identifier for the attribute.
Supporting Types
GetIamEntityV2AttributeList
- Attribute
Values List<string> - List of attribute values supported for access control.
- Display
Name string - Display name of the entity's attribute.
- Ext
Id string - External identifier of the IAM Entity.
- Links
List<Piers
Karsenbarg. Nutanix. Inputs. Get Iam Entity V2Attribute List Link> - HATEOAS links for the attribute (each with
hrefandrel). - Name string
- Name of the entity's attribute used in Authorization Policy filters.
- Supported
Operators List<string> - List of supported operators for this entity attribute.
- Tenant
Id string - Tenant identifier for the attribute.
- Attribute
Values []string - List of attribute values supported for access control.
- Display
Name string - Display name of the entity's attribute.
- Ext
Id string - External identifier of the IAM Entity.
- Links
[]Get
Iam Entity V2Attribute List Link - HATEOAS links for the attribute (each with
hrefandrel). - Name string
- Name of the entity's attribute used in Authorization Policy filters.
- Supported
Operators []string - List of supported operators for this entity attribute.
- Tenant
Id string - Tenant identifier for the attribute.
- attribute_
values list(string) - List of attribute values supported for access control.
- display_
name string - Display name of the entity's attribute.
- ext_
id string - External identifier of the IAM Entity.
- links list(object)
- HATEOAS links for the attribute (each with
hrefandrel). - name string
- Name of the entity's attribute used in Authorization Policy filters.
- supported_
operators list(string) - List of supported operators for this entity attribute.
- tenant_
id string - Tenant identifier for the attribute.
- attribute
Values List<String> - List of attribute values supported for access control.
- display
Name String - Display name of the entity's attribute.
- ext
Id String - External identifier of the IAM Entity.
- links
List<Get
Iam Entity V2Attribute List Link> - HATEOAS links for the attribute (each with
hrefandrel). - name String
- Name of the entity's attribute used in Authorization Policy filters.
- supported
Operators List<String> - List of supported operators for this entity attribute.
- tenant
Id String - Tenant identifier for the attribute.
- attribute
Values string[] - List of attribute values supported for access control.
- display
Name string - Display name of the entity's attribute.
- ext
Id string - External identifier of the IAM Entity.
- links
Get
Iam Entity V2Attribute List Link[] - HATEOAS links for the attribute (each with
hrefandrel). - name string
- Name of the entity's attribute used in Authorization Policy filters.
- supported
Operators string[] - List of supported operators for this entity attribute.
- tenant
Id string - Tenant identifier for the attribute.
- attribute_
values Sequence[str] - List of attribute values supported for access control.
- display_
name str - Display name of the entity's attribute.
- ext_
id str - External identifier of the IAM Entity.
- links
Sequence[Get
Iam Entity V2Attribute List Link] - HATEOAS links for the attribute (each with
hrefandrel). - name str
- Name of the entity's attribute used in Authorization Policy filters.
- supported_
operators Sequence[str] - List of supported operators for this entity attribute.
- tenant_
id str - Tenant identifier for the attribute.
- attribute
Values List<String> - List of attribute values supported for access control.
- display
Name String - Display name of the entity's attribute.
- ext
Id String - External identifier of the IAM Entity.
- links List<Property Map>
- HATEOAS links for the attribute (each with
hrefandrel). - name String
- Name of the entity's attribute used in Authorization Policy filters.
- supported
Operators List<String> - List of supported operators for this entity attribute.
- tenant
Id String - Tenant identifier for the attribute.
GetIamEntityV2AttributeListLink
GetIamEntityV2Link
Package Details
- Repository
- nutanix pierskarsenbarg/pulumi-nutanix
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
nutanixTerraform Provider.
Viewing docs for Nutanix v0.16.0
published on Tuesday, May 26, 2026 by Piers Karsenbarg
published on Tuesday, May 26, 2026 by Piers Karsenbarg