1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. iam
  5. getInstanceProfile

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.9.0 published on Monday, Nov 18, 2024 by Pulumi

aws-native.iam.getInstanceProfile

Explore with Pulumi AI

aws-native logo

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.9.0 published on Monday, Nov 18, 2024 by Pulumi

    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:

    InstanceProfileName string
    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: _+=,.@-
    InstanceProfileName string
    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: _+=,.@-
    instanceProfileName String
    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: _+=,.@-
    instanceProfileName string
    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_name str
    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: _+=,.@-
    instanceProfileName String
    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
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    AWS Cloud Control v1.9.0 published on Monday, Nov 18, 2024 by Pulumi