pulumiverse-scaleway 1.23.0a1736837529__py3-none-any.whl

pulumiverse_scaleway/get_secret.py

@@ -0,0 +1,338 @@
+# 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
+from . import outputs
+
+__all__ = [
+    'GetSecretResult',
+    'AwaitableGetSecretResult',
+    'get_secret',
+    'get_secret_output',
+]
+
+@pulumi.output_type
+class GetSecretResult:
+    """
+    A collection of values returned by getSecret.
+    """
+    def __init__(__self__, created_at=None, description=None, ephemeral_policies=None, id=None, name=None, organization_id=None, path=None, project_id=None, protected=None, region=None, secret_id=None, status=None, tags=None, type=None, updated_at=None, version_count=None):
+        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 ephemeral_policies and not isinstance(ephemeral_policies, list):
+            raise TypeError("Expected argument 'ephemeral_policies' to be a list")
+        pulumi.set(__self__, "ephemeral_policies", ephemeral_policies)
+        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 path and not isinstance(path, str):
+            raise TypeError("Expected argument 'path' to be a str")
+        pulumi.set(__self__, "path", path)
+        if project_id and not isinstance(project_id, str):
+            raise TypeError("Expected argument 'project_id' to be a str")
+        pulumi.set(__self__, "project_id", project_id)
+        if protected and not isinstance(protected, bool):
+            raise TypeError("Expected argument 'protected' to be a bool")
+        pulumi.set(__self__, "protected", protected)
+        if region and not isinstance(region, str):
+            raise TypeError("Expected argument 'region' to be a str")
+        pulumi.set(__self__, "region", region)
+        if secret_id and not isinstance(secret_id, str):
+            raise TypeError("Expected argument 'secret_id' to be a str")
+        pulumi.set(__self__, "secret_id", secret_id)
+        if status and not isinstance(status, str):
+            raise TypeError("Expected argument 'status' to be a str")
+        pulumi.set(__self__, "status", status)
+        if tags and not isinstance(tags, list):
+            raise TypeError("Expected argument 'tags' to be a list")
+        pulumi.set(__self__, "tags", tags)
+        if type and not isinstance(type, str):
+            raise TypeError("Expected argument 'type' to be a str")
+        pulumi.set(__self__, "type", type)
+        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 version_count and not isinstance(version_count, int):
+            raise TypeError("Expected argument 'version_count' to be a int")
+        pulumi.set(__self__, "version_count", version_count)
+
+    @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="ephemeralPolicies")
+    def ephemeral_policies(self) -> Sequence['outputs.GetSecretEphemeralPolicyResult']:
+        return pulumi.get(self, "ephemeral_policies")
+
+    @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) -> str:
+        return pulumi.get(self, "organization_id")
+
+    @property
+    @pulumi.getter
+    def path(self) -> Optional[str]:
+        return pulumi.get(self, "path")
+
+    @property
+    @pulumi.getter(name="projectId")
+    def project_id(self) -> Optional[str]:
+        return pulumi.get(self, "project_id")
+
+    @property
+    @pulumi.getter
+    def protected(self) -> bool:
+        return pulumi.get(self, "protected")
+
+    @property
+    @pulumi.getter
+    def region(self) -> Optional[str]:
+        return pulumi.get(self, "region")
+
+    @property
+    @pulumi.getter(name="secretId")
+    def secret_id(self) -> Optional[str]:
+        return pulumi.get(self, "secret_id")
+
+    @property
+    @pulumi.getter
+    def status(self) -> str:
+        return pulumi.get(self, "status")
+
+    @property
+    @pulumi.getter
+    def tags(self) -> Sequence[str]:
+        return pulumi.get(self, "tags")
+
+    @property
+    @pulumi.getter
+    def type(self) -> str:
+        return pulumi.get(self, "type")
+
+    @property
+    @pulumi.getter(name="updatedAt")
+    def updated_at(self) -> str:
+        return pulumi.get(self, "updated_at")
+
+    @property
+    @pulumi.getter(name="versionCount")
+    def version_count(self) -> int:
+        return pulumi.get(self, "version_count")
+
+
+class AwaitableGetSecretResult(GetSecretResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetSecretResult(
+            created_at=self.created_at,
+            description=self.description,
+            ephemeral_policies=self.ephemeral_policies,
+            id=self.id,
+            name=self.name,
+            organization_id=self.organization_id,
+            path=self.path,
+            project_id=self.project_id,
+            protected=self.protected,
+            region=self.region,
+            secret_id=self.secret_id,
+            status=self.status,
+            tags=self.tags,
+            type=self.type,
+            updated_at=self.updated_at,
+            version_count=self.version_count)
+
+
+def get_secret(name: Optional[str] = None,
+               organization_id: Optional[str] = None,
+               path: Optional[str] = None,
+               project_id: Optional[str] = None,
+               region: Optional[str] = None,
+               secret_id: Optional[str] = None,
+               opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetSecretResult:
+    """
+    The `Secret` data source is used to get information about a specific secret in Scaleway's Secret Manager.
+
+    Refer to the Secret Manager [product documentation](https://www.scaleway.com/en/docs/identity-and-access-management/secret-manager/) and [API documentation](https://www.scaleway.com/en/developers/api/secret-manager/) for more information.
+
+    ## Example Usage
+
+    ### Create a secret and get its information
+
+    The following commands allow you to:
+
+    - create a secret named `foo` with the description `barr`
+    - retrieve the secret's information using the secret's ID
+    - retrieve the secret's information using the secret's name
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    # Create a secret
+    main = scaleway.Secret("main",
+        name="foo",
+        description="barr")
+    # Get the secret information specified by the secret ID
+    my_secret = scaleway.get_secret(secret_id="11111111-1111-1111-1111-111111111111")
+    # Get the secret information specified by the secret name
+    by_name = scaleway.get_secret(name="your_secret_name")
+    ```
+
+
+    :param str name: The name of the secret.
+           Only one of `name` and `secret_id` should be specified.
+    :param str organization_id: The ID of the Scaleway Organization the Project is associated with. If no default `organization_id` is set, it must be set explicitly in this data source.
+    :param str path: The path of the secret.
+           Conflicts with `secret_id`.
+    :param str project_id: ). The ID of the
+           Project the secret is associated with.
+    :param str region: ). The region in which the secret exists.
+    :param str secret_id: The ID of the secret.
+           Only one of `name` and `secret_id` should be specified.
+    """
+    __args__ = dict()
+    __args__['name'] = name
+    __args__['organizationId'] = organization_id
+    __args__['path'] = path
+    __args__['projectId'] = project_id
+    __args__['region'] = region
+    __args__['secretId'] = secret_id
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('scaleway:index/getSecret:getSecret', __args__, opts=opts, typ=GetSecretResult).value
+
+    return AwaitableGetSecretResult(
+        created_at=pulumi.get(__ret__, 'created_at'),
+        description=pulumi.get(__ret__, 'description'),
+        ephemeral_policies=pulumi.get(__ret__, 'ephemeral_policies'),
+        id=pulumi.get(__ret__, 'id'),
+        name=pulumi.get(__ret__, 'name'),
+        organization_id=pulumi.get(__ret__, 'organization_id'),
+        path=pulumi.get(__ret__, 'path'),
+        project_id=pulumi.get(__ret__, 'project_id'),
+        protected=pulumi.get(__ret__, 'protected'),
+        region=pulumi.get(__ret__, 'region'),
+        secret_id=pulumi.get(__ret__, 'secret_id'),
+        status=pulumi.get(__ret__, 'status'),
+        tags=pulumi.get(__ret__, 'tags'),
+        type=pulumi.get(__ret__, 'type'),
+        updated_at=pulumi.get(__ret__, 'updated_at'),
+        version_count=pulumi.get(__ret__, 'version_count'))
+def get_secret_output(name: Optional[pulumi.Input[Optional[str]]] = None,
+                      organization_id: Optional[pulumi.Input[Optional[str]]] = None,
+                      path: Optional[pulumi.Input[Optional[str]]] = None,
+                      project_id: Optional[pulumi.Input[Optional[str]]] = None,
+                      region: Optional[pulumi.Input[Optional[str]]] = None,
+                      secret_id: Optional[pulumi.Input[Optional[str]]] = None,
+                      opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetSecretResult]:
+    """
+    The `Secret` data source is used to get information about a specific secret in Scaleway's Secret Manager.
+
+    Refer to the Secret Manager [product documentation](https://www.scaleway.com/en/docs/identity-and-access-management/secret-manager/) and [API documentation](https://www.scaleway.com/en/developers/api/secret-manager/) for more information.
+
+    ## Example Usage
+
+    ### Create a secret and get its information
+
+    The following commands allow you to:
+
+    - create a secret named `foo` with the description `barr`
+    - retrieve the secret's information using the secret's ID
+    - retrieve the secret's information using the secret's name
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    # Create a secret
+    main = scaleway.Secret("main",
+        name="foo",
+        description="barr")
+    # Get the secret information specified by the secret ID
+    my_secret = scaleway.get_secret(secret_id="11111111-1111-1111-1111-111111111111")
+    # Get the secret information specified by the secret name
+    by_name = scaleway.get_secret(name="your_secret_name")
+    ```
+
+
+    :param str name: The name of the secret.
+           Only one of `name` and `secret_id` should be specified.
+    :param str organization_id: The ID of the Scaleway Organization the Project is associated with. If no default `organization_id` is set, it must be set explicitly in this data source.
+    :param str path: The path of the secret.
+           Conflicts with `secret_id`.
+    :param str project_id: ). The ID of the
+           Project the secret is associated with.
+    :param str region: ). The region in which the secret exists.
+    :param str secret_id: The ID of the secret.
+           Only one of `name` and `secret_id` should be specified.
+    """
+    __args__ = dict()
+    __args__['name'] = name
+    __args__['organizationId'] = organization_id
+    __args__['path'] = path
+    __args__['projectId'] = project_id
+    __args__['region'] = region
+    __args__['secretId'] = secret_id
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('scaleway:index/getSecret:getSecret', __args__, opts=opts, typ=GetSecretResult)
+    return __ret__.apply(lambda __response__: GetSecretResult(
+        created_at=pulumi.get(__response__, 'created_at'),
+        description=pulumi.get(__response__, 'description'),
+        ephemeral_policies=pulumi.get(__response__, 'ephemeral_policies'),
+        id=pulumi.get(__response__, 'id'),
+        name=pulumi.get(__response__, 'name'),
+        organization_id=pulumi.get(__response__, 'organization_id'),
+        path=pulumi.get(__response__, 'path'),
+        project_id=pulumi.get(__response__, 'project_id'),
+        protected=pulumi.get(__response__, 'protected'),
+        region=pulumi.get(__response__, 'region'),
+        secret_id=pulumi.get(__response__, 'secret_id'),
+        status=pulumi.get(__response__, 'status'),
+        tags=pulumi.get(__response__, 'tags'),
+        type=pulumi.get(__response__, 'type'),
+        updated_at=pulumi.get(__response__, 'updated_at'),
+        version_count=pulumi.get(__response__, 'version_count')))

pulumiverse_scaleway/get_secret_version.py

@@ -0,0 +1,340 @@
+# 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__ = [
+    'GetSecretVersionResult',
+    'AwaitableGetSecretVersionResult',
+    'get_secret_version',
+    'get_secret_version_output',
+]
+
+@pulumi.output_type
+class GetSecretVersionResult:
+    """
+    A collection of values returned by getSecretVersion.
+    """
+    def __init__(__self__, created_at=None, data=None, description=None, id=None, organization_id=None, project_id=None, region=None, revision=None, secret_id=None, secret_name=None, status=None, updated_at=None):
+        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 data and not isinstance(data, str):
+            raise TypeError("Expected argument 'data' to be a str")
+        pulumi.set(__self__, "data", data)
+        if description and not isinstance(description, str):
+            raise TypeError("Expected argument 'description' to be a str")
+        pulumi.set(__self__, "description", description)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        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 project_id and not isinstance(project_id, str):
+            raise TypeError("Expected argument 'project_id' to be a str")
+        pulumi.set(__self__, "project_id", project_id)
+        if region and not isinstance(region, str):
+            raise TypeError("Expected argument 'region' to be a str")
+        pulumi.set(__self__, "region", region)
+        if revision and not isinstance(revision, str):
+            raise TypeError("Expected argument 'revision' to be a str")
+        pulumi.set(__self__, "revision", revision)
+        if secret_id and not isinstance(secret_id, str):
+            raise TypeError("Expected argument 'secret_id' to be a str")
+        pulumi.set(__self__, "secret_id", secret_id)
+        if secret_name and not isinstance(secret_name, str):
+            raise TypeError("Expected argument 'secret_name' to be a str")
+        pulumi.set(__self__, "secret_name", secret_name)
+        if status and not isinstance(status, str):
+            raise TypeError("Expected argument 'status' to be a str")
+        pulumi.set(__self__, "status", status)
+        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="createdAt")
+    def created_at(self) -> str:
+        """
+        The date and time of the secret version's creation in RFC 3339 format.
+        """
+        return pulumi.get(self, "created_at")
+
+    @property
+    @pulumi.getter
+    def data(self) -> str:
+        """
+        The data payload of the secret version. This is a sensitive attribute containing the secret value. Learn more in the [data section](https://www.terraform.io/#data-information).
+        """
+        return pulumi.get(self, "data")
+
+    @property
+    @pulumi.getter
+    def description(self) -> str:
+        """
+        (Optional) The description of the secret version (e.g. `my-new-description`).
+        """
+        return pulumi.get(self, "description")
+
+    @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="organizationId")
+    def organization_id(self) -> str:
+        return pulumi.get(self, "organization_id")
+
+    @property
+    @pulumi.getter(name="projectId")
+    def project_id(self) -> Optional[str]:
+        return pulumi.get(self, "project_id")
+
+    @property
+    @pulumi.getter
+    def region(self) -> Optional[str]:
+        return pulumi.get(self, "region")
+
+    @property
+    @pulumi.getter
+    def revision(self) -> Optional[str]:
+        return pulumi.get(self, "revision")
+
+    @property
+    @pulumi.getter(name="secretId")
+    def secret_id(self) -> Optional[str]:
+        return pulumi.get(self, "secret_id")
+
+    @property
+    @pulumi.getter(name="secretName")
+    def secret_name(self) -> Optional[str]:
+        return pulumi.get(self, "secret_name")
+
+    @property
+    @pulumi.getter
+    def status(self) -> str:
+        """
+        The status of the secret version.
+        """
+        return pulumi.get(self, "status")
+
+    @property
+    @pulumi.getter(name="updatedAt")
+    def updated_at(self) -> str:
+        """
+        The date and time of the secret version's last update in RFC 3339 format.
+        """
+        return pulumi.get(self, "updated_at")
+
+
+class AwaitableGetSecretVersionResult(GetSecretVersionResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetSecretVersionResult(
+            created_at=self.created_at,
+            data=self.data,
+            description=self.description,
+            id=self.id,
+            organization_id=self.organization_id,
+            project_id=self.project_id,
+            region=self.region,
+            revision=self.revision,
+            secret_id=self.secret_id,
+            secret_name=self.secret_name,
+            status=self.status,
+            updated_at=self.updated_at)
+
+
+def get_secret_version(organization_id: Optional[str] = None,
+                       project_id: Optional[str] = None,
+                       region: Optional[str] = None,
+                       revision: Optional[str] = None,
+                       secret_id: Optional[str] = None,
+                       secret_name: Optional[str] = None,
+                       opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetSecretVersionResult:
+    """
+    The `SecretVersion` data source is used to get information about a specific secret version stored in Scaleway Secret Manager.
+
+    Refer to the Secret Manager [product documentation](https://www.scaleway.com/en/docs/identity-and-access-management/secret-manager/) and [API documentation](https://www.scaleway.com/en/developers/api/secret-manager/) for more information.
+
+    ## Example Usage
+
+    ### Use Secret Manager
+
+    The following commands allow you to:
+
+    - create a secret named `fooii`
+    - create a new version of `fooii` containing data (`your_secret`)
+    - retrieve the secret version specified by the secret ID and the desired version
+    - retrieve the secret version specified by the secret name and the desired version
+
+    The output blocks display the sensitive data contained in your secret version.
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    # Create a secret named fooii
+    main = scaleway.Secret("main",
+        name="fooii",
+        description="barr")
+    # Create a version of fooii containing data
+    main_secret_version = scaleway.SecretVersion("main",
+        description="your description",
+        secret_id=main.id,
+        data="your_secret")
+    # Retrieve the secret version specified by the secret ID and the desired version
+    data_by_secret_id = scaleway.get_secret_version_output(secret_id=main.id,
+        revision="1")
+    # Retrieve the secret version specified by the secret name and the desired version
+    data_by_secret_name = scaleway.get_secret_version_output(secret_name=main.name,
+        revision="1")
+    pulumi.export("scalewaySecretAccessPayload", data_by_secret_name.data)
+    pulumi.export("scalewaySecretAccessPayloadById", data_by_secret_id.data)
+    ```
+
+    ## Data information
+
+    Note: This data source provides you with access to the secret payload, which is encoded in base64.
+
+    Keep in mind that this is a sensitive attribute. For more information,
+    see Sensitive Data in State.
+
+    > **Important:**  This property is sensitive and will not be displayed in the pulumi preview, for security reasons.
+
+
+    :param str project_id: The ID of the Scaleway Project associated with the secret version.
+    :param str revision: The revision for this secret version. Refer to alternative values (ex: `latest`) in the [API documentation](https://www.scaleway.com/en/developers/api/secret-manager/#path-secret-versions-access-a-secrets-version-using-the-secrets-id)
+    :param str secret_id: The ID of the secret associated with the secret version. Only one of `secret_id` and `secret_name` should be specified.
+    :param str secret_name: The name of the secret associated with the secret version.
+           Only one of `secret_id` and `secret_name` should be specified.
+    """
+    __args__ = dict()
+    __args__['organizationId'] = organization_id
+    __args__['projectId'] = project_id
+    __args__['region'] = region
+    __args__['revision'] = revision
+    __args__['secretId'] = secret_id
+    __args__['secretName'] = secret_name
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('scaleway:index/getSecretVersion:getSecretVersion', __args__, opts=opts, typ=GetSecretVersionResult).value
+
+    return AwaitableGetSecretVersionResult(
+        created_at=pulumi.get(__ret__, 'created_at'),
+        data=pulumi.get(__ret__, 'data'),
+        description=pulumi.get(__ret__, 'description'),
+        id=pulumi.get(__ret__, 'id'),
+        organization_id=pulumi.get(__ret__, 'organization_id'),
+        project_id=pulumi.get(__ret__, 'project_id'),
+        region=pulumi.get(__ret__, 'region'),
+        revision=pulumi.get(__ret__, 'revision'),
+        secret_id=pulumi.get(__ret__, 'secret_id'),
+        secret_name=pulumi.get(__ret__, 'secret_name'),
+        status=pulumi.get(__ret__, 'status'),
+        updated_at=pulumi.get(__ret__, 'updated_at'))
+def get_secret_version_output(organization_id: Optional[pulumi.Input[Optional[str]]] = None,
+                              project_id: Optional[pulumi.Input[Optional[str]]] = None,
+                              region: Optional[pulumi.Input[Optional[str]]] = None,
+                              revision: Optional[pulumi.Input[Optional[str]]] = None,
+                              secret_id: Optional[pulumi.Input[Optional[str]]] = None,
+                              secret_name: Optional[pulumi.Input[Optional[str]]] = None,
+                              opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetSecretVersionResult]:
+    """
+    The `SecretVersion` data source is used to get information about a specific secret version stored in Scaleway Secret Manager.
+
+    Refer to the Secret Manager [product documentation](https://www.scaleway.com/en/docs/identity-and-access-management/secret-manager/) and [API documentation](https://www.scaleway.com/en/developers/api/secret-manager/) for more information.
+
+    ## Example Usage
+
+    ### Use Secret Manager
+
+    The following commands allow you to:
+
+    - create a secret named `fooii`
+    - create a new version of `fooii` containing data (`your_secret`)
+    - retrieve the secret version specified by the secret ID and the desired version
+    - retrieve the secret version specified by the secret name and the desired version
+
+    The output blocks display the sensitive data contained in your secret version.
+
+    ```python
+    import pulumi
+    import pulumi_scaleway as scaleway
+    import pulumiverse_scaleway as scaleway
+
+    # Create a secret named fooii
+    main = scaleway.Secret("main",
+        name="fooii",
+        description="barr")
+    # Create a version of fooii containing data
+    main_secret_version = scaleway.SecretVersion("main",
+        description="your description",
+        secret_id=main.id,
+        data="your_secret")
+    # Retrieve the secret version specified by the secret ID and the desired version
+    data_by_secret_id = scaleway.get_secret_version_output(secret_id=main.id,
+        revision="1")
+    # Retrieve the secret version specified by the secret name and the desired version
+    data_by_secret_name = scaleway.get_secret_version_output(secret_name=main.name,
+        revision="1")
+    pulumi.export("scalewaySecretAccessPayload", data_by_secret_name.data)
+    pulumi.export("scalewaySecretAccessPayloadById", data_by_secret_id.data)
+    ```
+
+    ## Data information
+
+    Note: This data source provides you with access to the secret payload, which is encoded in base64.
+
+    Keep in mind that this is a sensitive attribute. For more information,
+    see Sensitive Data in State.
+
+    > **Important:**  This property is sensitive and will not be displayed in the pulumi preview, for security reasons.
+
+
+    :param str project_id: The ID of the Scaleway Project associated with the secret version.
+    :param str revision: The revision for this secret version. Refer to alternative values (ex: `latest`) in the [API documentation](https://www.scaleway.com/en/developers/api/secret-manager/#path-secret-versions-access-a-secrets-version-using-the-secrets-id)
+    :param str secret_id: The ID of the secret associated with the secret version. Only one of `secret_id` and `secret_name` should be specified.
+    :param str secret_name: The name of the secret associated with the secret version.
+           Only one of `secret_id` and `secret_name` should be specified.
+    """
+    __args__ = dict()
+    __args__['organizationId'] = organization_id
+    __args__['projectId'] = project_id
+    __args__['region'] = region
+    __args__['revision'] = revision
+    __args__['secretId'] = secret_id
+    __args__['secretName'] = secret_name
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('scaleway:index/getSecretVersion:getSecretVersion', __args__, opts=opts, typ=GetSecretVersionResult)
+    return __ret__.apply(lambda __response__: GetSecretVersionResult(
+        created_at=pulumi.get(__response__, 'created_at'),
+        data=pulumi.get(__response__, 'data'),
+        description=pulumi.get(__response__, 'description'),
+        id=pulumi.get(__response__, 'id'),
+        organization_id=pulumi.get(__response__, 'organization_id'),
+        project_id=pulumi.get(__response__, 'project_id'),
+        region=pulumi.get(__response__, 'region'),
+        revision=pulumi.get(__response__, 'revision'),
+        secret_id=pulumi.get(__response__, 'secret_id'),
+        secret_name=pulumi.get(__response__, 'secret_name'),
+        status=pulumi.get(__response__, 'status'),
+        updated_at=pulumi.get(__response__, 'updated_at')))