UNPKG

@pulumi/gcp

Version:

A Pulumi package for creating and managing Google Cloud Platform resources.

129 lines (128 loc) 5.57 kB
import * as pulumi from "@pulumi/pulumi"; /** * subcategory: "Secret Manager" * page_title: "Google: gcp.secretmanager.getRegionalSecretVersionAccess" * description: |- * Get a payload of Secret Manager regional secret's version. * --- * * Get the value from a Secret Manager regional secret version. This is similar to the gcp.secretmanager.RegionalSecretVersion datasource, but it only requires the [Secret Manager Secret Accessor](https://cloud.google.com/secret-manager/docs/access-control#secretmanager.secretAccessor) role. For more information see the [official documentation](https://cloud.google.com/secret-manager/docs/regional-secrets-overview) and [API](https://cloud.google.com/secret-manager/docs/reference/rest/v1/projects.locations.secrets.versions/access). * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const latest = gcp.secretmanager.getRegionalSecretVersionAccess({ * secret: "my-secret", * location: "us-central1", * }); * ``` */ export declare function getRegionalSecretVersionAccess(args: GetRegionalSecretVersionAccessArgs, opts?: pulumi.InvokeOptions): Promise<GetRegionalSecretVersionAccessResult>; /** * A collection of arguments for invoking getRegionalSecretVersionAccess. */ export interface GetRegionalSecretVersionAccessArgs { /** * If set to 'true', the secret data is * expected to be base64-encoded string. */ isSecretDataBase64?: boolean; /** * Location of Secret Manager regional secret resource. * It must be provided when the `secret` field provided consists of only the name of the regional secret. */ location?: string; /** * The project to get the secret version for. If it * is not provided, the provider project is used. */ project?: string; /** * The regional secret to get the secret version for. * This can be either the reference of the regional secret as in `projects/{{project}}/locations/{{location}}/secrets/{{secret_id}}` or only the name of the regional secret as in `{{secret_id}}`. If only the name of the regional secret is provided, the location must also be provided. */ secret: string; /** * The version of the regional secret to get. If it * is not provided, the latest version is retrieved. */ version?: string; } /** * A collection of values returned by getRegionalSecretVersionAccess. */ export interface GetRegionalSecretVersionAccessResult { /** * The provider-assigned unique ID for this managed resource. */ readonly id: string; readonly isSecretDataBase64?: boolean; readonly location: string; /** * The resource name of the regional SecretVersion. Format: * `projects/{{project}}/locations/{{location}}/secrets/{{secret_id}}/versions/{{version}}` */ readonly name: string; readonly project: string; readonly secret: string; /** * The secret data. No larger than 64KiB. */ readonly secretData: string; readonly version: string; } /** * subcategory: "Secret Manager" * page_title: "Google: gcp.secretmanager.getRegionalSecretVersionAccess" * description: |- * Get a payload of Secret Manager regional secret's version. * --- * * Get the value from a Secret Manager regional secret version. This is similar to the gcp.secretmanager.RegionalSecretVersion datasource, but it only requires the [Secret Manager Secret Accessor](https://cloud.google.com/secret-manager/docs/access-control#secretmanager.secretAccessor) role. For more information see the [official documentation](https://cloud.google.com/secret-manager/docs/regional-secrets-overview) and [API](https://cloud.google.com/secret-manager/docs/reference/rest/v1/projects.locations.secrets.versions/access). * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const latest = gcp.secretmanager.getRegionalSecretVersionAccess({ * secret: "my-secret", * location: "us-central1", * }); * ``` */ export declare function getRegionalSecretVersionAccessOutput(args: GetRegionalSecretVersionAccessOutputArgs, opts?: pulumi.InvokeOutputOptions): pulumi.Output<GetRegionalSecretVersionAccessResult>; /** * A collection of arguments for invoking getRegionalSecretVersionAccess. */ export interface GetRegionalSecretVersionAccessOutputArgs { /** * If set to 'true', the secret data is * expected to be base64-encoded string. */ isSecretDataBase64?: pulumi.Input<boolean>; /** * Location of Secret Manager regional secret resource. * It must be provided when the `secret` field provided consists of only the name of the regional secret. */ location?: pulumi.Input<string>; /** * The project to get the secret version for. If it * is not provided, the provider project is used. */ project?: pulumi.Input<string>; /** * The regional secret to get the secret version for. * This can be either the reference of the regional secret as in `projects/{{project}}/locations/{{location}}/secrets/{{secret_id}}` or only the name of the regional secret as in `{{secret_id}}`. If only the name of the regional secret is provided, the location must also be provided. */ secret: pulumi.Input<string>; /** * The version of the regional secret to get. If it * is not provided, the latest version is retrieved. */ version?: pulumi.Input<string>; }