pulumiverse-scaleway 1.23.0a1736837529__py3-none-any.whl

pulumiverse_scaleway/get_iam_api_key.py

@@ -0,0 +1,210 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from . import _utilities
+
+__all__ = [
+    'GetIamApiKeyResult',
+    'AwaitableGetIamApiKeyResult',
+    'get_iam_api_key',
+    'get_iam_api_key_output',
+]
+
+@pulumi.output_type
+class GetIamApiKeyResult:
+    """
+    A collection of values returned by getIamApiKey.
+    """
+    def __init__(__self__, access_key=None, application_id=None, created_at=None, creation_ip=None, default_project_id=None, description=None, editable=None, expires_at=None, id=None, updated_at=None, user_id=None):
+        if access_key and not isinstance(access_key, str):
+            raise TypeError("Expected argument 'access_key' to be a str")
+        pulumi.set(__self__, "access_key", access_key)
+        if application_id and not isinstance(application_id, str):
+            raise TypeError("Expected argument 'application_id' to be a str")
+        pulumi.set(__self__, "application_id", application_id)
+        if created_at and not isinstance(created_at, str):
+            raise TypeError("Expected argument 'created_at' to be a str")
+        pulumi.set(__self__, "created_at", created_at)
+        if creation_ip and not isinstance(creation_ip, str):
+            raise TypeError("Expected argument 'creation_ip' to be a str")
+        pulumi.set(__self__, "creation_ip", creation_ip)
+        if default_project_id and not isinstance(default_project_id, str):
+            raise TypeError("Expected argument 'default_project_id' to be a str")
+        pulumi.set(__self__, "default_project_id", default_project_id)
+        if description and not isinstance(description, str):
+            raise TypeError("Expected argument 'description' to be a str")
+        pulumi.set(__self__, "description", description)
+        if editable and not isinstance(editable, bool):
+            raise TypeError("Expected argument 'editable' to be a bool")
+        pulumi.set(__self__, "editable", editable)
+        if expires_at and not isinstance(expires_at, str):
+            raise TypeError("Expected argument 'expires_at' to be a str")
+        pulumi.set(__self__, "expires_at", expires_at)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if updated_at and not isinstance(updated_at, str):
+            raise TypeError("Expected argument 'updated_at' to be a str")
+        pulumi.set(__self__, "updated_at", updated_at)
+        if user_id and not isinstance(user_id, str):
+            raise TypeError("Expected argument 'user_id' to be a str")
+        pulumi.set(__self__, "user_id", user_id)
+
+    @property
+    @pulumi.getter(name="accessKey")
+    def access_key(self) -> str:
+        return pulumi.get(self, "access_key")
+
+    @property
+    @pulumi.getter(name="applicationId")
+    def application_id(self) -> str:
+        return pulumi.get(self, "application_id")
+
+    @property
+    @pulumi.getter(name="createdAt")
+    def created_at(self) -> str:
+        return pulumi.get(self, "created_at")
+
+    @property
+    @pulumi.getter(name="creationIp")
+    def creation_ip(self) -> str:
+        return pulumi.get(self, "creation_ip")
+
+    @property
+    @pulumi.getter(name="defaultProjectId")
+    def default_project_id(self) -> str:
+        return pulumi.get(self, "default_project_id")
+
+    @property
+    @pulumi.getter
+    def description(self) -> str:
+        return pulumi.get(self, "description")
+
+    @property
+    @pulumi.getter
+    def editable(self) -> bool:
+        return pulumi.get(self, "editable")
+
+    @property
+    @pulumi.getter(name="expiresAt")
+    def expires_at(self) -> str:
+        return pulumi.get(self, "expires_at")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="updatedAt")
+    def updated_at(self) -> str:
+        return pulumi.get(self, "updated_at")
+
+    @property
+    @pulumi.getter(name="userId")
+    def user_id(self) -> str:
+        return pulumi.get(self, "user_id")
+
+
+class AwaitableGetIamApiKeyResult(GetIamApiKeyResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetIamApiKeyResult(
+            access_key=self.access_key,
+            application_id=self.application_id,
+            created_at=self.created_at,
+            creation_ip=self.creation_ip,
+            default_project_id=self.default_project_id,
+            description=self.description,
+            editable=self.editable,
+            expires_at=self.expires_at,
+            id=self.id,
+            updated_at=self.updated_at,
+            user_id=self.user_id)
+
+
+def get_iam_api_key(access_key: Optional[str] = None,
+                    opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetIamApiKeyResult:
+    """
+    Gets information about an existing IAM API key. For more information, refer to the [IAM API documentation](https://www.scaleway.com/en/developers/api/iam/#api-keys-3665ae).
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+
+    # Get api key infos by id (access_key)
+    main = scaleway.get_iam_api_key(access_key="SCWABCDEFGHIJKLMNOPQ")
+    ```
+
+
+    :param str access_key: The access key of the IAM API key which is also the ID of the API key.
+    """
+    __args__ = dict()
+    __args__['accessKey'] = access_key
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('scaleway:index/getIamApiKey:getIamApiKey', __args__, opts=opts, typ=GetIamApiKeyResult).value
+
+    return AwaitableGetIamApiKeyResult(
+        access_key=pulumi.get(__ret__, 'access_key'),
+        application_id=pulumi.get(__ret__, 'application_id'),
+        created_at=pulumi.get(__ret__, 'created_at'),
+        creation_ip=pulumi.get(__ret__, 'creation_ip'),
+        default_project_id=pulumi.get(__ret__, 'default_project_id'),
+        description=pulumi.get(__ret__, 'description'),
+        editable=pulumi.get(__ret__, 'editable'),
+        expires_at=pulumi.get(__ret__, 'expires_at'),
+        id=pulumi.get(__ret__, 'id'),
+        updated_at=pulumi.get(__ret__, 'updated_at'),
+        user_id=pulumi.get(__ret__, 'user_id'))
+def get_iam_api_key_output(access_key: Optional[pulumi.Input[str]] = None,
+                           opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetIamApiKeyResult]:
+    """
+    Gets information about an existing IAM API key. For more information, refer to the [IAM API documentation](https://www.scaleway.com/en/developers/api/iam/#api-keys-3665ae).
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+
+    # Get api key infos by id (access_key)
+    main = scaleway.get_iam_api_key(access_key="SCWABCDEFGHIJKLMNOPQ")
+    ```
+
+
+    :param str access_key: The access key of the IAM API key which is also the ID of the API key.
+    """
+    __args__ = dict()
+    __args__['accessKey'] = access_key
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('scaleway:index/getIamApiKey:getIamApiKey', __args__, opts=opts, typ=GetIamApiKeyResult)
+    return __ret__.apply(lambda __response__: GetIamApiKeyResult(
+        access_key=pulumi.get(__response__, 'access_key'),
+        application_id=pulumi.get(__response__, 'application_id'),
+        created_at=pulumi.get(__response__, 'created_at'),
+        creation_ip=pulumi.get(__response__, 'creation_ip'),
+        default_project_id=pulumi.get(__response__, 'default_project_id'),
+        description=pulumi.get(__response__, 'description'),
+        editable=pulumi.get(__response__, 'editable'),
+        expires_at=pulumi.get(__response__, 'expires_at'),
+        id=pulumi.get(__response__, 'id'),
+        updated_at=pulumi.get(__response__, 'updated_at'),
+        user_id=pulumi.get(__response__, 'user_id')))

pulumiverse_scaleway/get_iam_application.py

@@ -0,0 +1,210 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from . import _utilities
+
+__all__ = [
+    'GetIamApplicationResult',
+    'AwaitableGetIamApplicationResult',
+    'get_iam_application',
+    'get_iam_application_output',
+]
+
+@pulumi.output_type
+class GetIamApplicationResult:
+    """
+    A collection of values returned by getIamApplication.
+    """
+    def __init__(__self__, application_id=None, created_at=None, description=None, editable=None, id=None, name=None, organization_id=None, tags=None, updated_at=None):
+        if application_id and not isinstance(application_id, str):
+            raise TypeError("Expected argument 'application_id' to be a str")
+        pulumi.set(__self__, "application_id", application_id)
+        if created_at and not isinstance(created_at, str):
+            raise TypeError("Expected argument 'created_at' to be a str")
+        pulumi.set(__self__, "created_at", created_at)
+        if description and not isinstance(description, str):
+            raise TypeError("Expected argument 'description' to be a str")
+        pulumi.set(__self__, "description", description)
+        if editable and not isinstance(editable, bool):
+            raise TypeError("Expected argument 'editable' to be a bool")
+        pulumi.set(__self__, "editable", editable)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if name and not isinstance(name, str):
+            raise TypeError("Expected argument 'name' to be a str")
+        pulumi.set(__self__, "name", name)
+        if organization_id and not isinstance(organization_id, str):
+            raise TypeError("Expected argument 'organization_id' to be a str")
+        pulumi.set(__self__, "organization_id", organization_id)
+        if tags and not isinstance(tags, list):
+            raise TypeError("Expected argument 'tags' to be a list")
+        pulumi.set(__self__, "tags", tags)
+        if updated_at and not isinstance(updated_at, str):
+            raise TypeError("Expected argument 'updated_at' to be a str")
+        pulumi.set(__self__, "updated_at", updated_at)
+
+    @property
+    @pulumi.getter(name="applicationId")
+    def application_id(self) -> Optional[str]:
+        return pulumi.get(self, "application_id")
+
+    @property
+    @pulumi.getter(name="createdAt")
+    def created_at(self) -> str:
+        return pulumi.get(self, "created_at")
+
+    @property
+    @pulumi.getter
+    def description(self) -> str:
+        return pulumi.get(self, "description")
+
+    @property
+    @pulumi.getter
+    def editable(self) -> bool:
+        return pulumi.get(self, "editable")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter
+    def name(self) -> Optional[str]:
+        return pulumi.get(self, "name")
+
+    @property
+    @pulumi.getter(name="organizationId")
+    def organization_id(self) -> Optional[str]:
+        return pulumi.get(self, "organization_id")
+
+    @property
+    @pulumi.getter
+    def tags(self) -> Sequence[str]:
+        return pulumi.get(self, "tags")
+
+    @property
+    @pulumi.getter(name="updatedAt")
+    def updated_at(self) -> str:
+        return pulumi.get(self, "updated_at")
+
+
+class AwaitableGetIamApplicationResult(GetIamApplicationResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetIamApplicationResult(
+            application_id=self.application_id,
+            created_at=self.created_at,
+            description=self.description,
+            editable=self.editable,
+            id=self.id,
+            name=self.name,
+            organization_id=self.organization_id,
+            tags=self.tags,
+            updated_at=self.updated_at)
+
+
+def get_iam_application(application_id: Optional[str] = None,
+                        name: Optional[str] = None,
+                        organization_id: Optional[str] = None,
+                        opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetIamApplicationResult:
+    """
+    Gets information about an existing IAM application.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+
+    # Get info by name
+    find_by_name = scaleway.get_iam_application(name="foobar")
+    # Get info by application ID
+    find_by_id = scaleway.get_iam_application(application_id="11111111-1111-1111-1111-111111111111")
+    ```
+
+
+    :param str application_id: The ID of the IAM application.
+           
+           > **Note** You must specify at least one: `name` and/or `application_id`.
+    :param str name: The name of the IAM application.
+    :param str organization_id: `organization_id`) The ID of the
+           Organization the application is associated with.
+    """
+    __args__ = dict()
+    __args__['applicationId'] = application_id
+    __args__['name'] = name
+    __args__['organizationId'] = organization_id
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('scaleway:index/getIamApplication:getIamApplication', __args__, opts=opts, typ=GetIamApplicationResult).value
+
+    return AwaitableGetIamApplicationResult(
+        application_id=pulumi.get(__ret__, 'application_id'),
+        created_at=pulumi.get(__ret__, 'created_at'),
+        description=pulumi.get(__ret__, 'description'),
+        editable=pulumi.get(__ret__, 'editable'),
+        id=pulumi.get(__ret__, 'id'),
+        name=pulumi.get(__ret__, 'name'),
+        organization_id=pulumi.get(__ret__, 'organization_id'),
+        tags=pulumi.get(__ret__, 'tags'),
+        updated_at=pulumi.get(__ret__, 'updated_at'))
+def get_iam_application_output(application_id: Optional[pulumi.Input[Optional[str]]] = None,
+                               name: Optional[pulumi.Input[Optional[str]]] = None,
+                               organization_id: Optional[pulumi.Input[Optional[str]]] = None,
+                               opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetIamApplicationResult]:
+    """
+    Gets information about an existing IAM application.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+
+    # Get info by name
+    find_by_name = scaleway.get_iam_application(name="foobar")
+    # Get info by application ID
+    find_by_id = scaleway.get_iam_application(application_id="11111111-1111-1111-1111-111111111111")
+    ```
+
+
+    :param str application_id: The ID of the IAM application.
+           
+           > **Note** You must specify at least one: `name` and/or `application_id`.
+    :param str name: The name of the IAM application.
+    :param str organization_id: `organization_id`) The ID of the
+           Organization the application is associated with.
+    """
+    __args__ = dict()
+    __args__['applicationId'] = application_id
+    __args__['name'] = name
+    __args__['organizationId'] = organization_id
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('scaleway:index/getIamApplication:getIamApplication', __args__, opts=opts, typ=GetIamApplicationResult)
+    return __ret__.apply(lambda __response__: GetIamApplicationResult(
+        application_id=pulumi.get(__response__, 'application_id'),
+        created_at=pulumi.get(__response__, 'created_at'),
+        description=pulumi.get(__response__, 'description'),
+        editable=pulumi.get(__response__, 'editable'),
+        id=pulumi.get(__response__, 'id'),
+        name=pulumi.get(__response__, 'name'),
+        organization_id=pulumi.get(__response__, 'organization_id'),
+        tags=pulumi.get(__response__, 'tags'),
+        updated_at=pulumi.get(__response__, 'updated_at')))

pulumiverse_scaleway/get_iam_group.py

@@ -0,0 +1,236 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from . import _utilities
+
+__all__ = [
+    'GetIamGroupResult',
+    'AwaitableGetIamGroupResult',
+    'get_iam_group',
+    'get_iam_group_output',
+]
+
+@pulumi.output_type
+class GetIamGroupResult:
+    """
+    A collection of values returned by getIamGroup.
+    """
+    def __init__(__self__, application_ids=None, created_at=None, description=None, external_membership=None, group_id=None, id=None, name=None, organization_id=None, tags=None, updated_at=None, user_ids=None):
+        if application_ids and not isinstance(application_ids, list):
+            raise TypeError("Expected argument 'application_ids' to be a list")
+        pulumi.set(__self__, "application_ids", application_ids)
+        if created_at and not isinstance(created_at, str):
+            raise TypeError("Expected argument 'created_at' to be a str")
+        pulumi.set(__self__, "created_at", created_at)
+        if description and not isinstance(description, str):
+            raise TypeError("Expected argument 'description' to be a str")
+        pulumi.set(__self__, "description", description)
+        if external_membership and not isinstance(external_membership, bool):
+            raise TypeError("Expected argument 'external_membership' to be a bool")
+        pulumi.set(__self__, "external_membership", external_membership)
+        if group_id and not isinstance(group_id, str):
+            raise TypeError("Expected argument 'group_id' to be a str")
+        pulumi.set(__self__, "group_id", group_id)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if name and not isinstance(name, str):
+            raise TypeError("Expected argument 'name' to be a str")
+        pulumi.set(__self__, "name", name)
+        if organization_id and not isinstance(organization_id, str):
+            raise TypeError("Expected argument 'organization_id' to be a str")
+        pulumi.set(__self__, "organization_id", organization_id)
+        if tags and not isinstance(tags, list):
+            raise TypeError("Expected argument 'tags' to be a list")
+        pulumi.set(__self__, "tags", tags)
+        if updated_at and not isinstance(updated_at, str):
+            raise TypeError("Expected argument 'updated_at' to be a str")
+        pulumi.set(__self__, "updated_at", updated_at)
+        if user_ids and not isinstance(user_ids, list):
+            raise TypeError("Expected argument 'user_ids' to be a list")
+        pulumi.set(__self__, "user_ids", user_ids)
+
+    @property
+    @pulumi.getter(name="applicationIds")
+    def application_ids(self) -> Sequence[str]:
+        return pulumi.get(self, "application_ids")
+
+    @property
+    @pulumi.getter(name="createdAt")
+    def created_at(self) -> str:
+        return pulumi.get(self, "created_at")
+
+    @property
+    @pulumi.getter
+    def description(self) -> str:
+        return pulumi.get(self, "description")
+
+    @property
+    @pulumi.getter(name="externalMembership")
+    def external_membership(self) -> bool:
+        return pulumi.get(self, "external_membership")
+
+    @property
+    @pulumi.getter(name="groupId")
+    def group_id(self) -> Optional[str]:
+        return pulumi.get(self, "group_id")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter
+    def name(self) -> Optional[str]:
+        return pulumi.get(self, "name")
+
+    @property
+    @pulumi.getter(name="organizationId")
+    def organization_id(self) -> Optional[str]:
+        return pulumi.get(self, "organization_id")
+
+    @property
+    @pulumi.getter
+    def tags(self) -> Sequence[str]:
+        return pulumi.get(self, "tags")
+
+    @property
+    @pulumi.getter(name="updatedAt")
+    def updated_at(self) -> str:
+        return pulumi.get(self, "updated_at")
+
+    @property
+    @pulumi.getter(name="userIds")
+    def user_ids(self) -> Sequence[str]:
+        return pulumi.get(self, "user_ids")
+
+
+class AwaitableGetIamGroupResult(GetIamGroupResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetIamGroupResult(
+            application_ids=self.application_ids,
+            created_at=self.created_at,
+            description=self.description,
+            external_membership=self.external_membership,
+            group_id=self.group_id,
+            id=self.id,
+            name=self.name,
+            organization_id=self.organization_id,
+            tags=self.tags,
+            updated_at=self.updated_at,
+            user_ids=self.user_ids)
+
+
+def get_iam_group(group_id: Optional[str] = None,
+                  name: Optional[str] = None,
+                  organization_id: Optional[str] = None,
+                  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetIamGroupResult:
+    """
+    Gets information about an existing IAM group.
+
+    For more information, refer to the [IAM API documentation](https://developers.scaleway.com/en/products/iam/api/v1alpha1/#applications-83ce5e)
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+
+    # Get info by name
+    find_by_name = scaleway.get_iam_group(name="foobar")
+    # Get info by group ID
+    find_by_id = scaleway.get_iam_group(group_id="11111111-1111-1111-1111-111111111111")
+    ```
+
+
+    :param str group_id: The ID of the IAM group.
+           
+           > **Note** You must specify at least one: `name` and/or `group_id`.
+    :param str name: The name of the IAM group.
+    :param str organization_id: `organization_id`) The ID of the
+           organization the group is associated with.
+    """
+    __args__ = dict()
+    __args__['groupId'] = group_id
+    __args__['name'] = name
+    __args__['organizationId'] = organization_id
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('scaleway:index/getIamGroup:getIamGroup', __args__, opts=opts, typ=GetIamGroupResult).value
+
+    return AwaitableGetIamGroupResult(
+        application_ids=pulumi.get(__ret__, 'application_ids'),
+        created_at=pulumi.get(__ret__, 'created_at'),
+        description=pulumi.get(__ret__, 'description'),
+        external_membership=pulumi.get(__ret__, 'external_membership'),
+        group_id=pulumi.get(__ret__, 'group_id'),
+        id=pulumi.get(__ret__, 'id'),
+        name=pulumi.get(__ret__, 'name'),
+        organization_id=pulumi.get(__ret__, 'organization_id'),
+        tags=pulumi.get(__ret__, 'tags'),
+        updated_at=pulumi.get(__ret__, 'updated_at'),
+        user_ids=pulumi.get(__ret__, 'user_ids'))
+def get_iam_group_output(group_id: Optional[pulumi.Input[Optional[str]]] = None,
+                         name: Optional[pulumi.Input[Optional[str]]] = None,
+                         organization_id: Optional[pulumi.Input[Optional[str]]] = None,
+                         opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetIamGroupResult]:
+    """
+    Gets information about an existing IAM group.
+
+    For more information, refer to the [IAM API documentation](https://developers.scaleway.com/en/products/iam/api/v1alpha1/#applications-83ce5e)
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+
+    # Get info by name
+    find_by_name = scaleway.get_iam_group(name="foobar")
+    # Get info by group ID
+    find_by_id = scaleway.get_iam_group(group_id="11111111-1111-1111-1111-111111111111")
+    ```
+
+
+    :param str group_id: The ID of the IAM group.
+           
+           > **Note** You must specify at least one: `name` and/or `group_id`.
+    :param str name: The name of the IAM group.
+    :param str organization_id: `organization_id`) The ID of the
+           organization the group is associated with.
+    """
+    __args__ = dict()
+    __args__['groupId'] = group_id
+    __args__['name'] = name
+    __args__['organizationId'] = organization_id
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('scaleway:index/getIamGroup:getIamGroup', __args__, opts=opts, typ=GetIamGroupResult)
+    return __ret__.apply(lambda __response__: GetIamGroupResult(
+        application_ids=pulumi.get(__response__, 'application_ids'),
+        created_at=pulumi.get(__response__, 'created_at'),
+        description=pulumi.get(__response__, 'description'),
+        external_membership=pulumi.get(__response__, 'external_membership'),
+        group_id=pulumi.get(__response__, 'group_id'),
+        id=pulumi.get(__response__, 'id'),
+        name=pulumi.get(__response__, 'name'),
+        organization_id=pulumi.get(__response__, 'organization_id'),
+        tags=pulumi.get(__response__, 'tags'),
+        updated_at=pulumi.get(__response__, 'updated_at'),
+        user_ids=pulumi.get(__response__, 'user_ids')))