import * as pulumi from "@pulumi/pulumi"; /** * Generate folder service identity for a service. * * > **Warning:** This resource is in beta, and should be used with the terraform-provider-google-beta provider. * See Provider Versions for more details on beta resources. * * > **Note:** Once created, this resource cannot be updated or destroyed. These * actions are a no-op. * * > **Note:** This resource can be used to retrieve the emails of the [Google-managed folder service accounts](https://cloud.google.com/iam/docs/service-agents) * of the APIs that Google has configured with a Service Identity. You can run `gcloud beta services identity create --service SERVICE_NAME.googleapis.com --folder FOLDER` to * verify if an API supports this. * * To get more information about Service Identity, see: * * * [API documentation](https://cloud.google.com/service-usage/docs/reference/rest/v1beta1/services/generateServiceIdentity) * * ## Example Usage * * ### Folder Service Identity Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const myFolder = new gcp.organizations.Folder("my_folder", { * parent: "organizations/1234567", * displayName: "my-folder", * }); * const osconfigSa = new gcp.folder.ServiceIdentity("osconfig_sa", { * folder: myFolder.folderId, * service: "osconfig.googleapis.com", * }); * const admin = new gcp.folder.IAMMember("admin", { * folder: myFolder.name, * role: "roles/osconfig.serviceAgent", * member: osconfigSa.member, * }); * ``` * * ## Import * * This resource does not support import. */ export declare class ServiceIdentity extends pulumi.CustomResource { /** * Get an existing ServiceIdentity resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: ServiceIdentityState, opts?: pulumi.CustomResourceOptions): ServiceIdentity; /** * Returns true if the given object is an instance of ServiceIdentity. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is ServiceIdentity; /** * The email address of the Google managed service account. */ readonly email: pulumi.Output; /** * The folder in which the resource belongs. */ readonly folder: pulumi.Output; /** * The Identity of the Google managed service account in the form 'serviceAccount:{email}'. This value is often used to refer to the service account in order to grant IAM permissions. */ readonly member: pulumi.Output; /** * The service to generate identity for. * * - - - */ readonly service: pulumi.Output; /** * Create a ServiceIdentity resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: ServiceIdentityArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering ServiceIdentity resources. */ export interface ServiceIdentityState { /** * The email address of the Google managed service account. */ email?: pulumi.Input; /** * The folder in which the resource belongs. */ folder?: pulumi.Input; /** * The Identity of the Google managed service account in the form 'serviceAccount:{email}'. This value is often used to refer to the service account in order to grant IAM permissions. */ member?: pulumi.Input; /** * The service to generate identity for. * * - - - */ service?: pulumi.Input; } /** * The set of arguments for constructing a ServiceIdentity resource. */ export interface ServiceIdentityArgs { /** * The folder in which the resource belongs. */ folder: pulumi.Input; /** * The service to generate identity for. * * - - - */ service: pulumi.Input; }