We recommend new projects start with resources from the AWS provider.
aws-native.iam.getInstanceProfile
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
Creates a new instance profile. For information about instance profiles, see Using instance profiles. For information about the number of instance profiles you can create, see object quotas in the User Guide.
Using getInstanceProfile
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 getInstanceProfile(args: GetInstanceProfileArgs, opts?: InvokeOptions): Promise<GetInstanceProfileResult>
function getInstanceProfileOutput(args: GetInstanceProfileOutputArgs, opts?: InvokeOptions): Output<GetInstanceProfileResult>
def get_instance_profile(instance_profile_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetInstanceProfileResult
def get_instance_profile_output(instance_profile_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetInstanceProfileResult]
func LookupInstanceProfile(ctx *Context, args *LookupInstanceProfileArgs, opts ...InvokeOption) (*LookupInstanceProfileResult, error)
func LookupInstanceProfileOutput(ctx *Context, args *LookupInstanceProfileOutputArgs, opts ...InvokeOption) LookupInstanceProfileResultOutput
> Note: This function is named LookupInstanceProfile
in the Go SDK.
public static class GetInstanceProfile
{
public static Task<GetInstanceProfileResult> InvokeAsync(GetInstanceProfileArgs args, InvokeOptions? opts = null)
public static Output<GetInstanceProfileResult> Invoke(GetInstanceProfileInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetInstanceProfileResult> getInstanceProfile(GetInstanceProfileArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:iam:getInstanceProfile
arguments:
# arguments dictionary
The following arguments are supported:
- Instance
Profile stringName - The name of the instance profile to create. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-
- Instance
Profile stringName - The name of the instance profile to create. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-
- instance
Profile StringName - The name of the instance profile to create. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-
- instance
Profile stringName - The name of the instance profile to create. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-
- instance_
profile_ strname - The name of the instance profile to create. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-
- instance
Profile StringName - The name of the instance profile to create. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-
getInstanceProfile Result
The following output properties are available:
- Arn string
Returns the Amazon Resource Name (ARN) for the instance profile. For example:
{"Fn::GetAtt" : ["MyProfile", "Arn"] }
This returns a value such as
arn:aws:iam::1234567890:instance-profile/MyProfile-ASDNSDLKJ
.- Roles List<string>
- The name of the role to associate with the instance profile. Only one role can be assigned to an EC2 instance at a time, and all applications on the instance share the same role and permissions.
- Arn string
Returns the Amazon Resource Name (ARN) for the instance profile. For example:
{"Fn::GetAtt" : ["MyProfile", "Arn"] }
This returns a value such as
arn:aws:iam::1234567890:instance-profile/MyProfile-ASDNSDLKJ
.- Roles []string
- The name of the role to associate with the instance profile. Only one role can be assigned to an EC2 instance at a time, and all applications on the instance share the same role and permissions.
- arn String
Returns the Amazon Resource Name (ARN) for the instance profile. For example:
{"Fn::GetAtt" : ["MyProfile", "Arn"] }
This returns a value such as
arn:aws:iam::1234567890:instance-profile/MyProfile-ASDNSDLKJ
.- roles List<String>
- The name of the role to associate with the instance profile. Only one role can be assigned to an EC2 instance at a time, and all applications on the instance share the same role and permissions.
- arn string
Returns the Amazon Resource Name (ARN) for the instance profile. For example:
{"Fn::GetAtt" : ["MyProfile", "Arn"] }
This returns a value such as
arn:aws:iam::1234567890:instance-profile/MyProfile-ASDNSDLKJ
.- roles string[]
- The name of the role to associate with the instance profile. Only one role can be assigned to an EC2 instance at a time, and all applications on the instance share the same role and permissions.
- arn str
Returns the Amazon Resource Name (ARN) for the instance profile. For example:
{"Fn::GetAtt" : ["MyProfile", "Arn"] }
This returns a value such as
arn:aws:iam::1234567890:instance-profile/MyProfile-ASDNSDLKJ
.- roles Sequence[str]
- The name of the role to associate with the instance profile. Only one role can be assigned to an EC2 instance at a time, and all applications on the instance share the same role and permissions.
- arn String
Returns the Amazon Resource Name (ARN) for the instance profile. For example:
{"Fn::GetAtt" : ["MyProfile", "Arn"] }
This returns a value such as
arn:aws:iam::1234567890:instance-profile/MyProfile-ASDNSDLKJ
.- roles List<String>
- The name of the role to associate with the instance profile. Only one role can be assigned to an EC2 instance at a time, and all applications on the instance share the same role and permissions.
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.