awscontroltower.Provider
Explore with Pulumi AI
The provider type for the awscontroltower package. By default, resources use package-wide configuration
settings, however an explicit Provider
instance may be created and passed during resource
construction to achieve fine-grained programmatic control over provider settings. See the
documentation for more information.
Create Provider Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Provider(name: string, args: ProviderArgs, opts?: CustomResourceOptions);
@overload
def Provider(resource_name: str,
args: ProviderArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Provider(resource_name: str,
opts: Optional[ResourceOptions] = None,
access_key: Optional[str] = None,
assume_role: Optional[ProviderAssumeRoleArgs] = None,
max_retries: Optional[int] = None,
profile: Optional[str] = None,
region: Optional[str] = None,
secret_key: Optional[str] = None,
shared_credentials_file: Optional[str] = None,
skip_credentials_validation: Optional[bool] = None,
skip_metadata_api_check: Optional[bool] = None,
skip_requesting_account_id: Optional[bool] = None,
token: Optional[str] = None)
func NewProvider(ctx *Context, name string, args ProviderArgs, opts ...ResourceOption) (*Provider, error)
public Provider(string name, ProviderArgs args, CustomResourceOptions? opts = null)
public Provider(String name, ProviderArgs args)
public Provider(String name, ProviderArgs args, CustomResourceOptions options)
type: pulumi:providers:awscontroltower
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 ProviderArgs
- 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 ProviderArgs
- 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 ProviderArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Provider Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Provider resource accepts the following input properties:
- Region string
- This is the AWS region. It must be provided, but it can also be sourced from the
AWS_DEFAULT_REGION
environment variables, or via a shared credentials file ifprofile
is specified. - Access
Key string - This is the AWS access key. It must be provided, but it can also be sourced from the
AWS_ACCESS_KEY_ID
environment variable, or via a shared credentials file ifprofile
is specified. - Assume
Role Lbrlabs.Pulumi Package. Awscontroltower. Inputs. Provider Assume Role - Settings for making use of the AWS Assume Role functionality.
- Max
Retries int - This is the maximum number of times an API call is retried, in the case where requests are being throttled or
experiencing transient failures. The delay between the subsequent API calls increases exponentially. If omitted, the
default value is
25
. - Profile string
- This is the AWS profile name as set in the shared credentials file.
- Secret
Key string - This is the AWS secret key. It must be provided, but it can also be sourced from the
AWS_SECRET_ACCESS_KEY
environment variable, or via a shared credentials file ifprofile
is specified. - string
- This is the path to the shared credentials file. If this is not set and a profile is specified,
~/.aws/credentials
will be used. - Skip
Credentials boolValidation - Skip the credentials validation via the STS API. Useful for AWS API implementations that do not have STS available or implemented.
- Skip
Metadata boolApi Check - Skip the AWS Metadata API check. Useful for AWS API implementations that do not have a metadata API endpoint. Setting to
true
prevents Terraform from authenticating via the Metadata API. You may need to use other authentication methods like static credentials, configuration variables, or environment variables. - Skip
Requesting boolAccount Id - Skip requesting the account ID. Useful for AWS API implementations that do not have the IAM, STS API, or metadata API.
- Token string
- Session token for validating temporary credentials. Typically provided after successful identity federation or
Multi-Factor Authentication (MFA) login. With MFA login, this is the session token provided afterward, not the 6 digit
MFA code used to get temporary credentials. It can also be sourced from the
AWS_SESSION_TOKEN
environment variable.
- Region string
- This is the AWS region. It must be provided, but it can also be sourced from the
AWS_DEFAULT_REGION
environment variables, or via a shared credentials file ifprofile
is specified. - Access
Key string - This is the AWS access key. It must be provided, but it can also be sourced from the
AWS_ACCESS_KEY_ID
environment variable, or via a shared credentials file ifprofile
is specified. - Assume
Role ProviderAssume Role Args - Settings for making use of the AWS Assume Role functionality.
- Max
Retries int - This is the maximum number of times an API call is retried, in the case where requests are being throttled or
experiencing transient failures. The delay between the subsequent API calls increases exponentially. If omitted, the
default value is
25
. - Profile string
- This is the AWS profile name as set in the shared credentials file.
- Secret
Key string - This is the AWS secret key. It must be provided, but it can also be sourced from the
AWS_SECRET_ACCESS_KEY
environment variable, or via a shared credentials file ifprofile
is specified. - string
- This is the path to the shared credentials file. If this is not set and a profile is specified,
~/.aws/credentials
will be used. - Skip
Credentials boolValidation - Skip the credentials validation via the STS API. Useful for AWS API implementations that do not have STS available or implemented.
- Skip
Metadata boolApi Check - Skip the AWS Metadata API check. Useful for AWS API implementations that do not have a metadata API endpoint. Setting to
true
prevents Terraform from authenticating via the Metadata API. You may need to use other authentication methods like static credentials, configuration variables, or environment variables. - Skip
Requesting boolAccount Id - Skip requesting the account ID. Useful for AWS API implementations that do not have the IAM, STS API, or metadata API.
- Token string
- Session token for validating temporary credentials. Typically provided after successful identity federation or
Multi-Factor Authentication (MFA) login. With MFA login, this is the session token provided afterward, not the 6 digit
MFA code used to get temporary credentials. It can also be sourced from the
AWS_SESSION_TOKEN
environment variable.
- region String
- This is the AWS region. It must be provided, but it can also be sourced from the
AWS_DEFAULT_REGION
environment variables, or via a shared credentials file ifprofile
is specified. - access
Key String - This is the AWS access key. It must be provided, but it can also be sourced from the
AWS_ACCESS_KEY_ID
environment variable, or via a shared credentials file ifprofile
is specified. - assume
Role ProviderAssume Role - Settings for making use of the AWS Assume Role functionality.
- max
Retries Integer - This is the maximum number of times an API call is retried, in the case where requests are being throttled or
experiencing transient failures. The delay between the subsequent API calls increases exponentially. If omitted, the
default value is
25
. - profile String
- This is the AWS profile name as set in the shared credentials file.
- secret
Key String - This is the AWS secret key. It must be provided, but it can also be sourced from the
AWS_SECRET_ACCESS_KEY
environment variable, or via a shared credentials file ifprofile
is specified. - String
- This is the path to the shared credentials file. If this is not set and a profile is specified,
~/.aws/credentials
will be used. - skip
Credentials BooleanValidation - Skip the credentials validation via the STS API. Useful for AWS API implementations that do not have STS available or implemented.
- skip
Metadata BooleanApi Check - Skip the AWS Metadata API check. Useful for AWS API implementations that do not have a metadata API endpoint. Setting to
true
prevents Terraform from authenticating via the Metadata API. You may need to use other authentication methods like static credentials, configuration variables, or environment variables. - skip
Requesting BooleanAccount Id - Skip requesting the account ID. Useful for AWS API implementations that do not have the IAM, STS API, or metadata API.
- token String
- Session token for validating temporary credentials. Typically provided after successful identity federation or
Multi-Factor Authentication (MFA) login. With MFA login, this is the session token provided afterward, not the 6 digit
MFA code used to get temporary credentials. It can also be sourced from the
AWS_SESSION_TOKEN
environment variable.
- region string
- This is the AWS region. It must be provided, but it can also be sourced from the
AWS_DEFAULT_REGION
environment variables, or via a shared credentials file ifprofile
is specified. - access
Key string - This is the AWS access key. It must be provided, but it can also be sourced from the
AWS_ACCESS_KEY_ID
environment variable, or via a shared credentials file ifprofile
is specified. - assume
Role ProviderAssume Role - Settings for making use of the AWS Assume Role functionality.
- max
Retries number - This is the maximum number of times an API call is retried, in the case where requests are being throttled or
experiencing transient failures. The delay between the subsequent API calls increases exponentially. If omitted, the
default value is
25
. - profile string
- This is the AWS profile name as set in the shared credentials file.
- secret
Key string - This is the AWS secret key. It must be provided, but it can also be sourced from the
AWS_SECRET_ACCESS_KEY
environment variable, or via a shared credentials file ifprofile
is specified. - string
- This is the path to the shared credentials file. If this is not set and a profile is specified,
~/.aws/credentials
will be used. - skip
Credentials booleanValidation - Skip the credentials validation via the STS API. Useful for AWS API implementations that do not have STS available or implemented.
- skip
Metadata booleanApi Check - Skip the AWS Metadata API check. Useful for AWS API implementations that do not have a metadata API endpoint. Setting to
true
prevents Terraform from authenticating via the Metadata API. You may need to use other authentication methods like static credentials, configuration variables, or environment variables. - skip
Requesting booleanAccount Id - Skip requesting the account ID. Useful for AWS API implementations that do not have the IAM, STS API, or metadata API.
- token string
- Session token for validating temporary credentials. Typically provided after successful identity federation or
Multi-Factor Authentication (MFA) login. With MFA login, this is the session token provided afterward, not the 6 digit
MFA code used to get temporary credentials. It can also be sourced from the
AWS_SESSION_TOKEN
environment variable.
- region str
- This is the AWS region. It must be provided, but it can also be sourced from the
AWS_DEFAULT_REGION
environment variables, or via a shared credentials file ifprofile
is specified. - access_
key str - This is the AWS access key. It must be provided, but it can also be sourced from the
AWS_ACCESS_KEY_ID
environment variable, or via a shared credentials file ifprofile
is specified. - assume_
role ProviderAssume Role Args - Settings for making use of the AWS Assume Role functionality.
- max_
retries int - This is the maximum number of times an API call is retried, in the case where requests are being throttled or
experiencing transient failures. The delay between the subsequent API calls increases exponentially. If omitted, the
default value is
25
. - profile str
- This is the AWS profile name as set in the shared credentials file.
- secret_
key str - This is the AWS secret key. It must be provided, but it can also be sourced from the
AWS_SECRET_ACCESS_KEY
environment variable, or via a shared credentials file ifprofile
is specified. - str
- This is the path to the shared credentials file. If this is not set and a profile is specified,
~/.aws/credentials
will be used. - skip_
credentials_ boolvalidation - Skip the credentials validation via the STS API. Useful for AWS API implementations that do not have STS available or implemented.
- skip_
metadata_ boolapi_ check - Skip the AWS Metadata API check. Useful for AWS API implementations that do not have a metadata API endpoint. Setting to
true
prevents Terraform from authenticating via the Metadata API. You may need to use other authentication methods like static credentials, configuration variables, or environment variables. - skip_
requesting_ boolaccount_ id - Skip requesting the account ID. Useful for AWS API implementations that do not have the IAM, STS API, or metadata API.
- token str
- Session token for validating temporary credentials. Typically provided after successful identity federation or
Multi-Factor Authentication (MFA) login. With MFA login, this is the session token provided afterward, not the 6 digit
MFA code used to get temporary credentials. It can also be sourced from the
AWS_SESSION_TOKEN
environment variable.
- region String
- This is the AWS region. It must be provided, but it can also be sourced from the
AWS_DEFAULT_REGION
environment variables, or via a shared credentials file ifprofile
is specified. - access
Key String - This is the AWS access key. It must be provided, but it can also be sourced from the
AWS_ACCESS_KEY_ID
environment variable, or via a shared credentials file ifprofile
is specified. - assume
Role Property Map - Settings for making use of the AWS Assume Role functionality.
- max
Retries Number - This is the maximum number of times an API call is retried, in the case where requests are being throttled or
experiencing transient failures. The delay between the subsequent API calls increases exponentially. If omitted, the
default value is
25
. - profile String
- This is the AWS profile name as set in the shared credentials file.
- secret
Key String - This is the AWS secret key. It must be provided, but it can also be sourced from the
AWS_SECRET_ACCESS_KEY
environment variable, or via a shared credentials file ifprofile
is specified. - String
- This is the path to the shared credentials file. If this is not set and a profile is specified,
~/.aws/credentials
will be used. - skip
Credentials BooleanValidation - Skip the credentials validation via the STS API. Useful for AWS API implementations that do not have STS available or implemented.
- skip
Metadata BooleanApi Check - Skip the AWS Metadata API check. Useful for AWS API implementations that do not have a metadata API endpoint. Setting to
true
prevents Terraform from authenticating via the Metadata API. You may need to use other authentication methods like static credentials, configuration variables, or environment variables. - skip
Requesting BooleanAccount Id - Skip requesting the account ID. Useful for AWS API implementations that do not have the IAM, STS API, or metadata API.
- token String
- Session token for validating temporary credentials. Typically provided after successful identity federation or
Multi-Factor Authentication (MFA) login. With MFA login, this is the session token provided afterward, not the 6 digit
MFA code used to get temporary credentials. It can also be sourced from the
AWS_SESSION_TOKEN
environment variable.
Outputs
All input properties are implicitly available as output properties. Additionally, the Provider 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.
Supporting Types
ProviderAssumeRole, ProviderAssumeRoleArgs
- Duration
Seconds int - External
Id string - Policy string
- Policy
Arns List<string> - Role
Arn string - Session
Name string - Dictionary<string, string>
- Transitive
Tag List<string>Keys
- Duration
Seconds int - External
Id string - Policy string
- Policy
Arns []string - Role
Arn string - Session
Name string - map[string]string
- Transitive
Tag []stringKeys
- duration
Seconds Integer - external
Id String - policy String
- policy
Arns List<String> - role
Arn String - session
Name String - Map<String,String>
- transitive
Tag List<String>Keys
- duration
Seconds number - external
Id string - policy string
- policy
Arns string[] - role
Arn string - session
Name string - {[key: string]: string}
- transitive
Tag string[]Keys
- duration_
seconds int - external_
id str - policy str
- policy_
arns Sequence[str] - role_
arn str - session_
name str - Mapping[str, str]
- transitive_
tag_ Sequence[str]keys
- duration
Seconds Number - external
Id String - policy String
- policy
Arns List<String> - role
Arn String - session
Name String - Map<String>
- transitive
Tag List<String>Keys
Package Details
- Repository
- awscontroltower lbrlabs/pulumi-awscontroltower
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
awscontroltower
Terraform Provider.