1. Packages
  2. HashiCorp Vault
  3. API Docs
  4. identity
  5. getEntity
HashiCorp Vault v6.0.0 published on Monday, Mar 25, 2024 by Pulumi

vault.identity.getEntity

Explore with Pulumi AI

vault logo
HashiCorp Vault v6.0.0 published on Monday, Mar 25, 2024 by Pulumi

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as vault from "@pulumi/vault";
    
    const entity = vault.identity.getEntity({
        entityName: "entity_12345",
    });
    
    import pulumi
    import pulumi_vault as vault
    
    entity = vault.identity.get_entity(entity_name="entity_12345")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-vault/sdk/v6/go/vault/identity"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := identity.LookupEntity(ctx, &identity.LookupEntityArgs{
    			EntityName: pulumi.StringRef("entity_12345"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Vault = Pulumi.Vault;
    
    return await Deployment.RunAsync(() => 
    {
        var entity = Vault.Identity.GetEntity.Invoke(new()
        {
            EntityName = "entity_12345",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.vault.identity.IdentityFunctions;
    import com.pulumi.vault.identity.inputs.GetEntityArgs;
    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 entity = IdentityFunctions.getEntity(GetEntityArgs.builder()
                .entityName("entity_12345")
                .build());
    
        }
    }
    
    variables:
      entity:
        fn::invoke:
          Function: vault:identity:getEntity
          Arguments:
            entityName: entity_12345
    

    Required Vault Capabilities

    Use of this resource requires the create capability on /identity/lookup/entity.

    Using getEntity

    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 getEntity(args: GetEntityArgs, opts?: InvokeOptions): Promise<GetEntityResult>
    function getEntityOutput(args: GetEntityOutputArgs, opts?: InvokeOptions): Output<GetEntityResult>
    def get_entity(alias_id: Optional[str] = None,
                   alias_mount_accessor: Optional[str] = None,
                   alias_name: Optional[str] = None,
                   entity_id: Optional[str] = None,
                   entity_name: Optional[str] = None,
                   namespace: Optional[str] = None,
                   opts: Optional[InvokeOptions] = None) -> GetEntityResult
    def get_entity_output(alias_id: Optional[pulumi.Input[str]] = None,
                   alias_mount_accessor: Optional[pulumi.Input[str]] = None,
                   alias_name: Optional[pulumi.Input[str]] = None,
                   entity_id: Optional[pulumi.Input[str]] = None,
                   entity_name: Optional[pulumi.Input[str]] = None,
                   namespace: Optional[pulumi.Input[str]] = None,
                   opts: Optional[InvokeOptions] = None) -> Output[GetEntityResult]
    func LookupEntity(ctx *Context, args *LookupEntityArgs, opts ...InvokeOption) (*LookupEntityResult, error)
    func LookupEntityOutput(ctx *Context, args *LookupEntityOutputArgs, opts ...InvokeOption) LookupEntityResultOutput

    > Note: This function is named LookupEntity in the Go SDK.

    public static class GetEntity 
    {
        public static Task<GetEntityResult> InvokeAsync(GetEntityArgs args, InvokeOptions? opts = null)
        public static Output<GetEntityResult> Invoke(GetEntityInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetEntityResult> getEntity(GetEntityArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: vault:identity/getEntity:getEntity
      arguments:
        # arguments dictionary

    The following arguments are supported:

    AliasId string
    ID of the alias.
    AliasMountAccessor string

    Accessor of the mount to which the alias belongs to. This should be supplied in conjunction with alias_name.

    The lookup criteria can be entity_name, entity_id, alias_id, or a combination of alias_name and alias_mount_accessor.

    AliasName string
    Name of the alias. This should be supplied in conjunction with alias_mount_accessor.
    EntityId string
    ID of the entity.
    EntityName string
    Name of the entity.
    Namespace string
    The namespace of the target resource. The value should not contain leading or trailing forward slashes. The namespace is always relative to the provider's configured namespace. Available only for Vault Enterprise.
    AliasId string
    ID of the alias.
    AliasMountAccessor string

    Accessor of the mount to which the alias belongs to. This should be supplied in conjunction with alias_name.

    The lookup criteria can be entity_name, entity_id, alias_id, or a combination of alias_name and alias_mount_accessor.

    AliasName string
    Name of the alias. This should be supplied in conjunction with alias_mount_accessor.
    EntityId string
    ID of the entity.
    EntityName string
    Name of the entity.
    Namespace string
    The namespace of the target resource. The value should not contain leading or trailing forward slashes. The namespace is always relative to the provider's configured namespace. Available only for Vault Enterprise.
    aliasId String
    ID of the alias.
    aliasMountAccessor String

    Accessor of the mount to which the alias belongs to. This should be supplied in conjunction with alias_name.

    The lookup criteria can be entity_name, entity_id, alias_id, or a combination of alias_name and alias_mount_accessor.

    aliasName String
    Name of the alias. This should be supplied in conjunction with alias_mount_accessor.
    entityId String
    ID of the entity.
    entityName String
    Name of the entity.
    namespace String
    The namespace of the target resource. The value should not contain leading or trailing forward slashes. The namespace is always relative to the provider's configured namespace. Available only for Vault Enterprise.
    aliasId string
    ID of the alias.
    aliasMountAccessor string

    Accessor of the mount to which the alias belongs to. This should be supplied in conjunction with alias_name.

    The lookup criteria can be entity_name, entity_id, alias_id, or a combination of alias_name and alias_mount_accessor.

    aliasName string
    Name of the alias. This should be supplied in conjunction with alias_mount_accessor.
    entityId string
    ID of the entity.
    entityName string
    Name of the entity.
    namespace string
    The namespace of the target resource. The value should not contain leading or trailing forward slashes. The namespace is always relative to the provider's configured namespace. Available only for Vault Enterprise.
    alias_id str
    ID of the alias.
    alias_mount_accessor str

    Accessor of the mount to which the alias belongs to. This should be supplied in conjunction with alias_name.

    The lookup criteria can be entity_name, entity_id, alias_id, or a combination of alias_name and alias_mount_accessor.

    alias_name str
    Name of the alias. This should be supplied in conjunction with alias_mount_accessor.
    entity_id str
    ID of the entity.
    entity_name str
    Name of the entity.
    namespace str
    The namespace of the target resource. The value should not contain leading or trailing forward slashes. The namespace is always relative to the provider's configured namespace. Available only for Vault Enterprise.
    aliasId String
    ID of the alias.
    aliasMountAccessor String

    Accessor of the mount to which the alias belongs to. This should be supplied in conjunction with alias_name.

    The lookup criteria can be entity_name, entity_id, alias_id, or a combination of alias_name and alias_mount_accessor.

    aliasName String
    Name of the alias. This should be supplied in conjunction with alias_mount_accessor.
    entityId String
    ID of the entity.
    entityName String
    Name of the entity.
    namespace String
    The namespace of the target resource. The value should not contain leading or trailing forward slashes. The namespace is always relative to the provider's configured namespace. Available only for Vault Enterprise.

    getEntity Result

    The following output properties are available:

    AliasId string
    AliasMountAccessor string
    AliasName string
    Aliases List<GetEntityAlias>
    A list of entity alias. Structure is documented below.
    CreationTime string
    Creation time of the Alias
    DataJson string
    A string containing the full data payload retrieved from Vault, serialized in JSON format.
    DirectGroupIds List<string>
    List of Group IDs of which the entity is directly a member of
    Disabled bool
    Whether the entity is disabled
    EntityId string
    EntityName string
    GroupIds List<string>
    List of all Group IDs of which the entity is a member of
    Id string
    The provider-assigned unique ID for this managed resource.
    InheritedGroupIds List<string>
    List of all Group IDs of which the entity is a member of transitively
    LastUpdateTime string
    Last update time of the alias
    MergedEntityIds List<string>
    Other entity IDs which is merged with this entity
    Metadata Dictionary<string, object>
    Arbitrary metadata
    NamespaceId string
    Namespace of which the entity is part of
    Policies List<string>
    List of policies attached to the entity
    Namespace string
    AliasId string
    AliasMountAccessor string
    AliasName string
    Aliases []GetEntityAliasType
    A list of entity alias. Structure is documented below.
    CreationTime string
    Creation time of the Alias
    DataJson string
    A string containing the full data payload retrieved from Vault, serialized in JSON format.
    DirectGroupIds []string
    List of Group IDs of which the entity is directly a member of
    Disabled bool
    Whether the entity is disabled
    EntityId string
    EntityName string
    GroupIds []string
    List of all Group IDs of which the entity is a member of
    Id string
    The provider-assigned unique ID for this managed resource.
    InheritedGroupIds []string
    List of all Group IDs of which the entity is a member of transitively
    LastUpdateTime string
    Last update time of the alias
    MergedEntityIds []string
    Other entity IDs which is merged with this entity
    Metadata map[string]interface{}
    Arbitrary metadata
    NamespaceId string
    Namespace of which the entity is part of
    Policies []string
    List of policies attached to the entity
    Namespace string
    aliasId String
    aliasMountAccessor String
    aliasName String
    aliases List<GetEntityAlias>
    A list of entity alias. Structure is documented below.
    creationTime String
    Creation time of the Alias
    dataJson String
    A string containing the full data payload retrieved from Vault, serialized in JSON format.
    directGroupIds List<String>
    List of Group IDs of which the entity is directly a member of
    disabled Boolean
    Whether the entity is disabled
    entityId String
    entityName String
    groupIds List<String>
    List of all Group IDs of which the entity is a member of
    id String
    The provider-assigned unique ID for this managed resource.
    inheritedGroupIds List<String>
    List of all Group IDs of which the entity is a member of transitively
    lastUpdateTime String
    Last update time of the alias
    mergedEntityIds List<String>
    Other entity IDs which is merged with this entity
    metadata Map<String,Object>
    Arbitrary metadata
    namespaceId String
    Namespace of which the entity is part of
    policies List<String>
    List of policies attached to the entity
    namespace String
    aliasId string
    aliasMountAccessor string
    aliasName string
    aliases GetEntityAlias[]
    A list of entity alias. Structure is documented below.
    creationTime string
    Creation time of the Alias
    dataJson string
    A string containing the full data payload retrieved from Vault, serialized in JSON format.
    directGroupIds string[]
    List of Group IDs of which the entity is directly a member of
    disabled boolean
    Whether the entity is disabled
    entityId string
    entityName string
    groupIds string[]
    List of all Group IDs of which the entity is a member of
    id string
    The provider-assigned unique ID for this managed resource.
    inheritedGroupIds string[]
    List of all Group IDs of which the entity is a member of transitively
    lastUpdateTime string
    Last update time of the alias
    mergedEntityIds string[]
    Other entity IDs which is merged with this entity
    metadata {[key: string]: any}
    Arbitrary metadata
    namespaceId string
    Namespace of which the entity is part of
    policies string[]
    List of policies attached to the entity
    namespace string
    alias_id str
    alias_mount_accessor str
    alias_name str
    aliases Sequence[GetEntityAlias]
    A list of entity alias. Structure is documented below.
    creation_time str
    Creation time of the Alias
    data_json str
    A string containing the full data payload retrieved from Vault, serialized in JSON format.
    direct_group_ids Sequence[str]
    List of Group IDs of which the entity is directly a member of
    disabled bool
    Whether the entity is disabled
    entity_id str
    entity_name str
    group_ids Sequence[str]
    List of all Group IDs of which the entity is a member of
    id str
    The provider-assigned unique ID for this managed resource.
    inherited_group_ids Sequence[str]
    List of all Group IDs of which the entity is a member of transitively
    last_update_time str
    Last update time of the alias
    merged_entity_ids Sequence[str]
    Other entity IDs which is merged with this entity
    metadata Mapping[str, Any]
    Arbitrary metadata
    namespace_id str
    Namespace of which the entity is part of
    policies Sequence[str]
    List of policies attached to the entity
    namespace str
    aliasId String
    aliasMountAccessor String
    aliasName String
    aliases List<Property Map>
    A list of entity alias. Structure is documented below.
    creationTime String
    Creation time of the Alias
    dataJson String
    A string containing the full data payload retrieved from Vault, serialized in JSON format.
    directGroupIds List<String>
    List of Group IDs of which the entity is directly a member of
    disabled Boolean
    Whether the entity is disabled
    entityId String
    entityName String
    groupIds List<String>
    List of all Group IDs of which the entity is a member of
    id String
    The provider-assigned unique ID for this managed resource.
    inheritedGroupIds List<String>
    List of all Group IDs of which the entity is a member of transitively
    lastUpdateTime String
    Last update time of the alias
    mergedEntityIds List<String>
    Other entity IDs which is merged with this entity
    metadata Map<Any>
    Arbitrary metadata
    namespaceId String
    Namespace of which the entity is part of
    policies List<String>
    List of policies attached to the entity
    namespace String

    Supporting Types

    GetEntityAlias

    CanonicalId string
    Canonical ID of the Alias
    CreationTime string
    Creation time of the Alias
    Id string
    ID of the alias
    LastUpdateTime string
    Last update time of the alias
    MergedFromCanonicalIds List<string>
    List of canonical IDs merged with this alias
    Metadata Dictionary<string, object>
    Arbitrary metadata
    MountAccessor string
    Authentication mount acccessor which this alias belongs to
    MountPath string
    Authentication mount path which this alias belongs to
    MountType string
    Authentication mount type which this alias belongs to
    Name string
    Name of the alias
    CanonicalId string
    Canonical ID of the Alias
    CreationTime string
    Creation time of the Alias
    Id string
    ID of the alias
    LastUpdateTime string
    Last update time of the alias
    MergedFromCanonicalIds []string
    List of canonical IDs merged with this alias
    Metadata map[string]interface{}
    Arbitrary metadata
    MountAccessor string
    Authentication mount acccessor which this alias belongs to
    MountPath string
    Authentication mount path which this alias belongs to
    MountType string
    Authentication mount type which this alias belongs to
    Name string
    Name of the alias
    canonicalId String
    Canonical ID of the Alias
    creationTime String
    Creation time of the Alias
    id String
    ID of the alias
    lastUpdateTime String
    Last update time of the alias
    mergedFromCanonicalIds List<String>
    List of canonical IDs merged with this alias
    metadata Map<String,Object>
    Arbitrary metadata
    mountAccessor String
    Authentication mount acccessor which this alias belongs to
    mountPath String
    Authentication mount path which this alias belongs to
    mountType String
    Authentication mount type which this alias belongs to
    name String
    Name of the alias
    canonicalId string
    Canonical ID of the Alias
    creationTime string
    Creation time of the Alias
    id string
    ID of the alias
    lastUpdateTime string
    Last update time of the alias
    mergedFromCanonicalIds string[]
    List of canonical IDs merged with this alias
    metadata {[key: string]: any}
    Arbitrary metadata
    mountAccessor string
    Authentication mount acccessor which this alias belongs to
    mountPath string
    Authentication mount path which this alias belongs to
    mountType string
    Authentication mount type which this alias belongs to
    name string
    Name of the alias
    canonical_id str
    Canonical ID of the Alias
    creation_time str
    Creation time of the Alias
    id str
    ID of the alias
    last_update_time str
    Last update time of the alias
    merged_from_canonical_ids Sequence[str]
    List of canonical IDs merged with this alias
    metadata Mapping[str, Any]
    Arbitrary metadata
    mount_accessor str
    Authentication mount acccessor which this alias belongs to
    mount_path str
    Authentication mount path which this alias belongs to
    mount_type str
    Authentication mount type which this alias belongs to
    name str
    Name of the alias
    canonicalId String
    Canonical ID of the Alias
    creationTime String
    Creation time of the Alias
    id String
    ID of the alias
    lastUpdateTime String
    Last update time of the alias
    mergedFromCanonicalIds List<String>
    List of canonical IDs merged with this alias
    metadata Map<Any>
    Arbitrary metadata
    mountAccessor String
    Authentication mount acccessor which this alias belongs to
    mountPath String
    Authentication mount path which this alias belongs to
    mountType String
    Authentication mount type which this alias belongs to
    name String
    Name of the alias

    Package Details

    Repository
    Vault pulumi/pulumi-vault
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the vault Terraform Provider.
    vault logo
    HashiCorp Vault v6.0.0 published on Monday, Mar 25, 2024 by Pulumi