import * as pulumi from "@pulumi/pulumi"; /** * The description of a dynamic collection of monitored resources. Each group * has a filter that is matched against monitored resources and their * associated metadata. If a group's filter matches an available monitored * resource, then that resource is a member of that group. * * To get more information about Group, see: * * * [API documentation](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.groups) * * How-to Guides * * [Official Documentation](https://cloud.google.com/monitoring/groups/) * * ## Example Usage * * ### Monitoring Group Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const basic = new gcp.monitoring.Group("basic", { * displayName: "tf-test MonitoringGroup", * filter: "resource.metadata.region=\"europe-west2\"", * }); * ``` * ### Monitoring Group Subgroup * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const parent = new gcp.monitoring.Group("parent", { * displayName: "tf-test MonitoringParentGroup", * filter: "resource.metadata.region=\"europe-west2\"", * }); * const subgroup = new gcp.monitoring.Group("subgroup", { * displayName: "tf-test MonitoringSubGroup", * filter: "resource.metadata.region=\"europe-west2\"", * parentName: parent.name, * }); * ``` * * ## Import * * Group can be imported using any of these accepted formats: * * * `{{project}}/{{name}}` * * * `{{project}} {{name}}` * * * `{{name}}` * * When using the `pulumi import` command, Group can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:monitoring/group:Group default {{project}}/{{name}} * ``` * * ```sh * $ pulumi import gcp:monitoring/group:Group default "{{project}} {{name}}" * ``` * * ```sh * $ pulumi import gcp:monitoring/group:Group default {{name}} * ``` */ export declare class Group extends pulumi.CustomResource { /** * Get an existing Group 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?: GroupState, opts?: pulumi.CustomResourceOptions): Group; /** * Returns true if the given object is an instance of Group. 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 Group; /** * A user-assigned name for this group, used only for display * purposes. */ readonly displayName: pulumi.Output; /** * The filter used to determine which monitored resources * belong to this group. */ readonly filter: pulumi.Output; /** * If true, the members of this group are considered to be a * cluster. The system can perform additional analysis on * groups that are clusters. */ readonly isCluster: pulumi.Output; /** * A unique identifier for this group. The format is * "projects/{project_id_or_number}/groups/{group_id}". */ readonly name: pulumi.Output; /** * The name of the group's parent, if it has one. The format is * "projects/{project_id_or_number}/groups/{group_id}". For * groups with no parent, parentName is the empty string, "". */ readonly parentName: pulumi.Output; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ readonly project: pulumi.Output; /** * Create a Group 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: GroupArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering Group resources. */ export interface GroupState { /** * A user-assigned name for this group, used only for display * purposes. */ displayName?: pulumi.Input; /** * The filter used to determine which monitored resources * belong to this group. */ filter?: pulumi.Input; /** * If true, the members of this group are considered to be a * cluster. The system can perform additional analysis on * groups that are clusters. */ isCluster?: pulumi.Input; /** * A unique identifier for this group. The format is * "projects/{project_id_or_number}/groups/{group_id}". */ name?: pulumi.Input; /** * The name of the group's parent, if it has one. The format is * "projects/{project_id_or_number}/groups/{group_id}". For * groups with no parent, parentName is the empty string, "". */ parentName?: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; } /** * The set of arguments for constructing a Group resource. */ export interface GroupArgs { /** * A user-assigned name for this group, used only for display * purposes. */ displayName: pulumi.Input; /** * The filter used to determine which monitored resources * belong to this group. */ filter: pulumi.Input; /** * If true, the members of this group are considered to be a * cluster. The system can perform additional analysis on * groups that are clusters. */ isCluster?: pulumi.Input; /** * The name of the group's parent, if it has one. The format is * "projects/{project_id_or_number}/groups/{group_id}". For * groups with no parent, parentName is the empty string, "". */ parentName?: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; }