vault.aws.AuthBackendClient
Explore with Pulumi AI
Example Usage
You can setup the AWS auth engine with Workload Identity Federation (WIF) for a secret-less configuration:
import * as pulumi from "@pulumi/pulumi";
import * as vault from "@pulumi/vault";
const example = new vault.AuthBackend("example", {type: "aws"});
const exampleAuthBackendClient = new vault.aws.AuthBackendClient("example", {
identityTokenAudience: "<TOKEN_AUDIENCE>",
identityTokenTtl: "<TOKEN_TTL>",
roleArn: "<AWS_ROLE_ARN>",
});
import pulumi
import pulumi_vault as vault
example = vault.AuthBackend("example", type="aws")
example_auth_backend_client = vault.aws.AuthBackendClient("example",
identity_token_audience="<TOKEN_AUDIENCE>",
identity_token_ttl="<TOKEN_TTL>",
role_arn="<AWS_ROLE_ARN>")
package main
import (
"github.com/pulumi/pulumi-vault/sdk/v6/go/vault"
"github.com/pulumi/pulumi-vault/sdk/v6/go/vault/aws"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := vault.NewAuthBackend(ctx, "example", &vault.AuthBackendArgs{
Type: pulumi.String("aws"),
})
if err != nil {
return err
}
_, err = aws.NewAuthBackendClient(ctx, "example", &aws.AuthBackendClientArgs{
IdentityTokenAudience: pulumi.String("<TOKEN_AUDIENCE>"),
IdentityTokenTtl: pulumi.Int("<TOKEN_TTL>"),
RoleArn: pulumi.String("<AWS_ROLE_ARN>"),
})
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 example = new Vault.AuthBackend("example", new()
{
Type = "aws",
});
var exampleAuthBackendClient = new Vault.Aws.AuthBackendClient("example", new()
{
IdentityTokenAudience = "<TOKEN_AUDIENCE>",
IdentityTokenTtl = "<TOKEN_TTL>",
RoleArn = "<AWS_ROLE_ARN>",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vault.AuthBackend;
import com.pulumi.vault.AuthBackendArgs;
import com.pulumi.vault.aws.AuthBackendClient;
import com.pulumi.vault.aws.AuthBackendClientArgs;
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) {
var example = new AuthBackend("example", AuthBackendArgs.builder()
.type("aws")
.build());
var exampleAuthBackendClient = new AuthBackendClient("exampleAuthBackendClient", AuthBackendClientArgs.builder()
.identityTokenAudience("<TOKEN_AUDIENCE>")
.identityTokenTtl("<TOKEN_TTL>")
.roleArn("<AWS_ROLE_ARN>")
.build());
}
}
resources:
example:
type: vault:AuthBackend
properties:
type: aws
exampleAuthBackendClient:
type: vault:aws:AuthBackendClient
name: example
properties:
identityTokenAudience: <TOKEN_AUDIENCE>
identityTokenTtl: <TOKEN_TTL>
roleArn: <AWS_ROLE_ARN>
import * as pulumi from "@pulumi/pulumi";
import * as vault from "@pulumi/vault";
const example = new vault.AuthBackend("example", {type: "aws"});
const exampleAuthBackendClient = new vault.aws.AuthBackendClient("example", {
backend: example.path,
accessKey: "INSERT_AWS_ACCESS_KEY",
secretKey: "INSERT_AWS_SECRET_KEY",
});
import pulumi
import pulumi_vault as vault
example = vault.AuthBackend("example", type="aws")
example_auth_backend_client = vault.aws.AuthBackendClient("example",
backend=example.path,
access_key="INSERT_AWS_ACCESS_KEY",
secret_key="INSERT_AWS_SECRET_KEY")
package main
import (
"github.com/pulumi/pulumi-vault/sdk/v6/go/vault"
"github.com/pulumi/pulumi-vault/sdk/v6/go/vault/aws"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := vault.NewAuthBackend(ctx, "example", &vault.AuthBackendArgs{
Type: pulumi.String("aws"),
})
if err != nil {
return err
}
_, err = aws.NewAuthBackendClient(ctx, "example", &aws.AuthBackendClientArgs{
Backend: example.Path,
AccessKey: pulumi.String("INSERT_AWS_ACCESS_KEY"),
SecretKey: pulumi.String("INSERT_AWS_SECRET_KEY"),
})
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 example = new Vault.AuthBackend("example", new()
{
Type = "aws",
});
var exampleAuthBackendClient = new Vault.Aws.AuthBackendClient("example", new()
{
Backend = example.Path,
AccessKey = "INSERT_AWS_ACCESS_KEY",
SecretKey = "INSERT_AWS_SECRET_KEY",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vault.AuthBackend;
import com.pulumi.vault.AuthBackendArgs;
import com.pulumi.vault.aws.AuthBackendClient;
import com.pulumi.vault.aws.AuthBackendClientArgs;
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) {
var example = new AuthBackend("example", AuthBackendArgs.builder()
.type("aws")
.build());
var exampleAuthBackendClient = new AuthBackendClient("exampleAuthBackendClient", AuthBackendClientArgs.builder()
.backend(example.path())
.accessKey("INSERT_AWS_ACCESS_KEY")
.secretKey("INSERT_AWS_SECRET_KEY")
.build());
}
}
resources:
example:
type: vault:AuthBackend
properties:
type: aws
exampleAuthBackendClient:
type: vault:aws:AuthBackendClient
name: example
properties:
backend: ${example.path}
accessKey: INSERT_AWS_ACCESS_KEY
secretKey: INSERT_AWS_SECRET_KEY
Create AuthBackendClient Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new AuthBackendClient(name: string, args?: AuthBackendClientArgs, opts?: CustomResourceOptions);
@overload
def AuthBackendClient(resource_name: str,
args: Optional[AuthBackendClientArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def AuthBackendClient(resource_name: str,
opts: Optional[ResourceOptions] = None,
access_key: Optional[str] = None,
backend: Optional[str] = None,
ec2_endpoint: Optional[str] = None,
iam_endpoint: Optional[str] = None,
iam_server_id_header_value: Optional[str] = None,
identity_token_audience: Optional[str] = None,
identity_token_ttl: Optional[int] = None,
max_retries: Optional[int] = None,
namespace: Optional[str] = None,
role_arn: Optional[str] = None,
secret_key: Optional[str] = None,
sts_endpoint: Optional[str] = None,
sts_region: Optional[str] = None,
use_sts_region_from_client: Optional[bool] = None)
func NewAuthBackendClient(ctx *Context, name string, args *AuthBackendClientArgs, opts ...ResourceOption) (*AuthBackendClient, error)
public AuthBackendClient(string name, AuthBackendClientArgs? args = null, CustomResourceOptions? opts = null)
public AuthBackendClient(String name, AuthBackendClientArgs args)
public AuthBackendClient(String name, AuthBackendClientArgs args, CustomResourceOptions options)
type: vault:aws:AuthBackendClient
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args AuthBackendClientArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args AuthBackendClientArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args AuthBackendClientArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AuthBackendClientArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AuthBackendClientArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var authBackendClientResource = new Vault.Aws.AuthBackendClient("authBackendClientResource", new()
{
AccessKey = "string",
Backend = "string",
Ec2Endpoint = "string",
IamEndpoint = "string",
IamServerIdHeaderValue = "string",
IdentityTokenAudience = "string",
IdentityTokenTtl = 0,
MaxRetries = 0,
Namespace = "string",
RoleArn = "string",
SecretKey = "string",
StsEndpoint = "string",
StsRegion = "string",
UseStsRegionFromClient = false,
});
example, err := aws.NewAuthBackendClient(ctx, "authBackendClientResource", &aws.AuthBackendClientArgs{
AccessKey: pulumi.String("string"),
Backend: pulumi.String("string"),
Ec2Endpoint: pulumi.String("string"),
IamEndpoint: pulumi.String("string"),
IamServerIdHeaderValue: pulumi.String("string"),
IdentityTokenAudience: pulumi.String("string"),
IdentityTokenTtl: pulumi.Int(0),
MaxRetries: pulumi.Int(0),
Namespace: pulumi.String("string"),
RoleArn: pulumi.String("string"),
SecretKey: pulumi.String("string"),
StsEndpoint: pulumi.String("string"),
StsRegion: pulumi.String("string"),
UseStsRegionFromClient: pulumi.Bool(false),
})
var authBackendClientResource = new AuthBackendClient("authBackendClientResource", AuthBackendClientArgs.builder()
.accessKey("string")
.backend("string")
.ec2Endpoint("string")
.iamEndpoint("string")
.iamServerIdHeaderValue("string")
.identityTokenAudience("string")
.identityTokenTtl(0)
.maxRetries(0)
.namespace("string")
.roleArn("string")
.secretKey("string")
.stsEndpoint("string")
.stsRegion("string")
.useStsRegionFromClient(false)
.build());
auth_backend_client_resource = vault.aws.AuthBackendClient("authBackendClientResource",
access_key="string",
backend="string",
ec2_endpoint="string",
iam_endpoint="string",
iam_server_id_header_value="string",
identity_token_audience="string",
identity_token_ttl=0,
max_retries=0,
namespace="string",
role_arn="string",
secret_key="string",
sts_endpoint="string",
sts_region="string",
use_sts_region_from_client=False)
const authBackendClientResource = new vault.aws.AuthBackendClient("authBackendClientResource", {
accessKey: "string",
backend: "string",
ec2Endpoint: "string",
iamEndpoint: "string",
iamServerIdHeaderValue: "string",
identityTokenAudience: "string",
identityTokenTtl: 0,
maxRetries: 0,
namespace: "string",
roleArn: "string",
secretKey: "string",
stsEndpoint: "string",
stsRegion: "string",
useStsRegionFromClient: false,
});
type: vault:aws:AuthBackendClient
properties:
accessKey: string
backend: string
ec2Endpoint: string
iamEndpoint: string
iamServerIdHeaderValue: string
identityTokenAudience: string
identityTokenTtl: 0
maxRetries: 0
namespace: string
roleArn: string
secretKey: string
stsEndpoint: string
stsRegion: string
useStsRegionFromClient: false
AuthBackendClient Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The AuthBackendClient resource accepts the following input properties:
- Access
Key string - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - Backend string
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - Ec2Endpoint string
- Override the URL Vault uses when making EC2 API calls.
- Iam
Endpoint string - Override the URL Vault uses when making IAM API calls.
- Iam
Server stringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - Identity
Token stringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - Identity
Token intTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- Max
Retries int - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - Namespace string
- The namespace to provision the resource in.
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. - Role
Arn string - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- Secret
Key string - The AWS secret key that Vault should use for the auth backend.
- Sts
Endpoint string - Override the URL Vault uses when making STS API calls.
- Sts
Region string - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - Use
Sts boolRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- Access
Key string - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - Backend string
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - Ec2Endpoint string
- Override the URL Vault uses when making EC2 API calls.
- Iam
Endpoint string - Override the URL Vault uses when making IAM API calls.
- Iam
Server stringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - Identity
Token stringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - Identity
Token intTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- Max
Retries int - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - Namespace string
- The namespace to provision the resource in.
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. - Role
Arn string - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- Secret
Key string - The AWS secret key that Vault should use for the auth backend.
- Sts
Endpoint string - Override the URL Vault uses when making STS API calls.
- Sts
Region string - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - Use
Sts boolRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- access
Key String - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - backend String
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - ec2Endpoint String
- Override the URL Vault uses when making EC2 API calls.
- iam
Endpoint String - Override the URL Vault uses when making IAM API calls.
- iam
Server StringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - identity
Token StringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - identity
Token IntegerTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- max
Retries Integer - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - namespace String
- The namespace to provision the resource in.
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. - role
Arn String - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- secret
Key String - The AWS secret key that Vault should use for the auth backend.
- sts
Endpoint String - Override the URL Vault uses when making STS API calls.
- sts
Region String - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - use
Sts BooleanRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- access
Key string - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - backend string
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - ec2Endpoint string
- Override the URL Vault uses when making EC2 API calls.
- iam
Endpoint string - Override the URL Vault uses when making IAM API calls.
- iam
Server stringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - identity
Token stringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - identity
Token numberTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- max
Retries number - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - namespace string
- The namespace to provision the resource in.
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. - role
Arn string - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- secret
Key string - The AWS secret key that Vault should use for the auth backend.
- sts
Endpoint string - Override the URL Vault uses when making STS API calls.
- sts
Region string - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - use
Sts booleanRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- access_
key str - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - backend str
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - ec2_
endpoint str - Override the URL Vault uses when making EC2 API calls.
- iam_
endpoint str - Override the URL Vault uses when making IAM API calls.
- iam_
server_ strid_ header_ value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - identity_
token_ straudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - identity_
token_ intttl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- max_
retries int - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - namespace str
- The namespace to provision the resource in.
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. - role_
arn str - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- secret_
key str - The AWS secret key that Vault should use for the auth backend.
- sts_
endpoint str - Override the URL Vault uses when making STS API calls.
- sts_
region str - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - use_
sts_ boolregion_ from_ client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- access
Key String - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - backend String
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - ec2Endpoint String
- Override the URL Vault uses when making EC2 API calls.
- iam
Endpoint String - Override the URL Vault uses when making IAM API calls.
- iam
Server StringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - identity
Token StringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - identity
Token NumberTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- max
Retries Number - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - namespace String
- The namespace to provision the resource in.
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. - role
Arn String - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- secret
Key String - The AWS secret key that Vault should use for the auth backend.
- sts
Endpoint String - Override the URL Vault uses when making STS API calls.
- sts
Region String - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - use
Sts BooleanRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
Outputs
All input properties are implicitly available as output properties. Additionally, the AuthBackendClient resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Look up Existing AuthBackendClient Resource
Get an existing AuthBackendClient resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: AuthBackendClientState, opts?: CustomResourceOptions): AuthBackendClient
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
access_key: Optional[str] = None,
backend: Optional[str] = None,
ec2_endpoint: Optional[str] = None,
iam_endpoint: Optional[str] = None,
iam_server_id_header_value: Optional[str] = None,
identity_token_audience: Optional[str] = None,
identity_token_ttl: Optional[int] = None,
max_retries: Optional[int] = None,
namespace: Optional[str] = None,
role_arn: Optional[str] = None,
secret_key: Optional[str] = None,
sts_endpoint: Optional[str] = None,
sts_region: Optional[str] = None,
use_sts_region_from_client: Optional[bool] = None) -> AuthBackendClient
func GetAuthBackendClient(ctx *Context, name string, id IDInput, state *AuthBackendClientState, opts ...ResourceOption) (*AuthBackendClient, error)
public static AuthBackendClient Get(string name, Input<string> id, AuthBackendClientState? state, CustomResourceOptions? opts = null)
public static AuthBackendClient get(String name, Output<String> id, AuthBackendClientState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Access
Key string - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - Backend string
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - Ec2Endpoint string
- Override the URL Vault uses when making EC2 API calls.
- Iam
Endpoint string - Override the URL Vault uses when making IAM API calls.
- Iam
Server stringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - Identity
Token stringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - Identity
Token intTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- Max
Retries int - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - Namespace string
- The namespace to provision the resource in.
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. - Role
Arn string - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- Secret
Key string - The AWS secret key that Vault should use for the auth backend.
- Sts
Endpoint string - Override the URL Vault uses when making STS API calls.
- Sts
Region string - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - Use
Sts boolRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- Access
Key string - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - Backend string
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - Ec2Endpoint string
- Override the URL Vault uses when making EC2 API calls.
- Iam
Endpoint string - Override the URL Vault uses when making IAM API calls.
- Iam
Server stringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - Identity
Token stringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - Identity
Token intTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- Max
Retries int - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - Namespace string
- The namespace to provision the resource in.
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. - Role
Arn string - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- Secret
Key string - The AWS secret key that Vault should use for the auth backend.
- Sts
Endpoint string - Override the URL Vault uses when making STS API calls.
- Sts
Region string - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - Use
Sts boolRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- access
Key String - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - backend String
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - ec2Endpoint String
- Override the URL Vault uses when making EC2 API calls.
- iam
Endpoint String - Override the URL Vault uses when making IAM API calls.
- iam
Server StringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - identity
Token StringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - identity
Token IntegerTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- max
Retries Integer - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - namespace String
- The namespace to provision the resource in.
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. - role
Arn String - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- secret
Key String - The AWS secret key that Vault should use for the auth backend.
- sts
Endpoint String - Override the URL Vault uses when making STS API calls.
- sts
Region String - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - use
Sts BooleanRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- access
Key string - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - backend string
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - ec2Endpoint string
- Override the URL Vault uses when making EC2 API calls.
- iam
Endpoint string - Override the URL Vault uses when making IAM API calls.
- iam
Server stringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - identity
Token stringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - identity
Token numberTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- max
Retries number - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - namespace string
- The namespace to provision the resource in.
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. - role
Arn string - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- secret
Key string - The AWS secret key that Vault should use for the auth backend.
- sts
Endpoint string - Override the URL Vault uses when making STS API calls.
- sts
Region string - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - use
Sts booleanRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- access_
key str - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - backend str
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - ec2_
endpoint str - Override the URL Vault uses when making EC2 API calls.
- iam_
endpoint str - Override the URL Vault uses when making IAM API calls.
- iam_
server_ strid_ header_ value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - identity_
token_ straudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - identity_
token_ intttl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- max_
retries int - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - namespace str
- The namespace to provision the resource in.
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. - role_
arn str - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- secret_
key str - The AWS secret key that Vault should use for the auth backend.
- sts_
endpoint str - Override the URL Vault uses when making STS API calls.
- sts_
region str - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - use_
sts_ boolregion_ from_ client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
- access
Key String - The AWS access key that Vault should use for the
auth backend. Mutually exclusive with
identity_token_audience
. - backend String
- The path the AWS auth backend being configured was
mounted at. Defaults to
aws
. - ec2Endpoint String
- Override the URL Vault uses when making EC2 API calls.
- iam
Endpoint String - Override the URL Vault uses when making IAM API calls.
- iam
Server StringId Header Value - The value to require in the
X-Vault-AWS-IAM-Server-ID
header as part ofGetCallerIdentity
requests that are used in the IAM auth method. - identity
Token StringAudience - The audience claim value. Mutually exclusive with
access_key
. Requires Vault 1.17+. Available only for Vault Enterprise - identity
Token NumberTtl - The TTL of generated identity tokens in seconds. Requires Vault 1.17+. Available only for Vault Enterprise
- max
Retries Number - Number of max retries the client should use for recoverable errors.
The default
-1
falls back to the AWS SDK's default behavior. - namespace String
- The namespace to provision the resource in.
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. - role
Arn String - Role ARN to assume for plugin identity token federation. Requires Vault 1.17+. Available only for Vault Enterprise
- secret
Key String - The AWS secret key that Vault should use for the auth backend.
- sts
Endpoint String - Override the URL Vault uses when making STS API calls.
- sts
Region String - Override the default region when making STS API
calls. The
sts_endpoint
argument must be set when usingsts_region
. - use
Sts BooleanRegion From Client - Available in Vault v1.15+. If set,
overrides both
sts_endpoint
andsts_region
to instead use the region specified in the client request headers for IAM-based authentication. This can be useful when you have client requests coming from different regions and want flexibility in which regional STS API is used.
Import
AWS auth backend clients can be imported using auth/
, the backend
path, and /config/client
e.g.
$ pulumi import vault:aws/authBackendClient:AuthBackendClient example auth/aws/config/client
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Vault pulumi/pulumi-vault
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
vault
Terraform Provider.