AddressGroupIamBinding class

Three different resources help you manage your IAM policy for Network Security ProjectAddressGroup. Each of these resources serves a different use case:

  • gcp.networksecurity.AddressGroupIamPolicy: Authoritative. Sets the IAM policy for the projectaddressgroup and replaces any existing policy already attached.
  • gcp.networksecurity.AddressGroupIamBinding: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the projectaddressgroup are preserved. Members added outside of Terraform for the same role will be detected as drift and removed on the next pulumi up.
  • gcp.networksecurity.AddressGroupIamMember: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the projectaddressgroup are preserved. Members added outside of Terraform will not be detected as drift.

A data source can be used to retrieve policy data in advent you do not need creation

  • gcp.networksecurity.AddressGroupIamPolicy: Retrieves the IAM policy for the projectaddressgroup

> Note: gcp.networksecurity.AddressGroupIamPolicy cannot be used in conjunction with gcp.networksecurity.AddressGroupIamBinding and gcp.networksecurity.AddressGroupIamMember or they will fight over what your policy should be.

> Note: gcp.networksecurity.AddressGroupIamBinding resources can be used in conjunction with gcp.networksecurity.AddressGroupIamMember resources only if they do not grant privilege to the same role.

gcp.networksecurity.AddressGroupIamPolicy

Import

For all import syntaxes, the "resource in question" can take any of the following forms:

  • projects/{{project}}/locations/{{location}}/addressGroups/{{name}}
  • {{project}}/{{location}}/{{name}}
  • {{location}}/{{name}}
  • {{name}}

Any variables not passed in the import command will be taken from the provider configuration.

Network Security projectaddressgroup IAM resources can be imported using the resource identifiers, role, and member.

IAM member imports use space-delimited identifiers: the resource in question, the role, and the member identity, e.g.

$ terraform import google_network_security_address_group_iam_member.editor "projects/{{project}}/locations/{{location}}/addressGroups/{{project_address_group}} roles/compute.networkAdmin user:jane@example.com"

IAM binding imports use space-delimited identifiers: the resource in question and the role, e.g.

$ terraform import google_network_security_address_group_iam_binding.editor "projects/{{project}}/locations/{{location}}/addressGroups/{{project_address_group}} roles/compute.networkAdmin"

IAM policy imports use the identifier of the resource in question, e.g.

$ pulumi import gcp:networksecurity/addressGroupIamBinding:AddressGroupIamBinding editor projects/{{project}}/locations/{{location}}/addressGroups/{{project_address_group}}

> Custom Roles If you're importing a IAM resource with a custom role, make sure to use the full name of the custom role, e.g. [projects/my-project|organizations/my-org]/roles/my-custom-role.

Constructors

AddressGroupIamBinding(String name, {AddressGroupIamBindingArgs? args, CustomResourceOptions? options})
Creates a new AddressGroupIamBinding. name The Pulumi resource name. args Arguments used to configure this AddressGroupIamBinding. The set of arguments for AddressGroupIamBinding. options Resource options controlling this resource's behavior.
AddressGroupIamBinding.reference(String urn)
Creates a typed reference to an existing AddressGroupIamBinding resource.

Properties

childResources → Set<Resource>
finalinherited
completionSources ↔ Map<String, IOutputCompletionSource>
latefinalinherited
condition ↔ Output<AddressGroupIamBindingCondition?>
latefinal
etag ↔ Output<String>
(Computed) The etag of the IAM policy.
latefinal
hashCode → int
The hash code for this object.
no setterinherited
id ↔ Output<String>
getter/setter pairinherited
isCustom → bool
Returns whether this resource is provider-managed.
no setterinherited
isProtected → bool
Returns whether this resource is protected from deletion.
no setterinherited
isRemote → bool
Whether this resource is registered as remote.
no setterinherited
isResourceReference → bool
Whether this instance represents a resource value returned over RPC.
finalinherited
location ↔ Output<String>
The location of the gateway security policy. Used to find the parent resource to bind the IAM policy to. If not specified, the value will be parsed from the identifier of the parent resource. If no location is provided in the parent identifier and no location is specified, it is taken from the provider configuration.
latefinal
members ↔ Output<List<String>>
Identities that will be granted the privilege in role. Each entry can have one of the following values:
latefinal
name ↔ Output<String>
Used to find the parent resource to bind the IAM policy to
latefinal
project ↔ Output<String>
The ID of the project in which the resource belongs. If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
latefinal
resourceTransforms → List<ResourceTransform>
Inherited/explicit async transforms.
no setterinherited
role ↔ Output<String>
The role that should be applied. Only one gcp.networksecurity.AddressGroupIamBinding can be used per role. Note that custom roles must be of the format [projects|organizations]/{parent-name}/roles/{role-name}.
latefinal
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
transformations → List<ResourceTransformation>
Inherited/explicit legacy transformations.
no setterinherited
urn ↔ Output<String>
latefinalinherited

Methods

failId(Object error) → void
Completes this resource ID with an error when registration fails.
inherited
failOutputs(Object error) → void
Completes all output properties with error.
inherited
failUrn(Object error) → void
Completes this resource URN with an error when registration fails.
inherited
getProvider(String moduleMember) → ProviderResource?
Returns provider for moduleMember's package, if configured.
inherited
getResourceName() → String
Returns this resource's logical name.
inherited
getResourceType() → String
Returns this resource's Pulumi type token.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
registerOutput<T>(String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output<T>
Registers a dynamic output property for this resource.
inherited
resolveId(String? value, {required bool isKnown}) → void
Resolves the provider-assigned ID for this resource.
inherited
resolveOutputs(Struct outputs) → void
Resolves all output properties from a monitor response payload.
inherited
resolveUrn(String value) → void
Resolves this resource's URN once assigned by the engine.
inherited
serializeProperties(Map<String, dynamic> properties) → Future<Struct>
Serializes resource properties for RPC transmission.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

get(String name, Input<String> id, {AddressGroupIamBindingState? state, CustomResourceOptions? options}) → AddressGroupIamBinding
Gets an existing AddressGroupIamBinding resource's state with the given name and id.