ConsumersIamMember class

Three different resources help you manage your IAM policy for Cloud Endpoints ServiceConsumers. Each of these resources serves a different use case:

  • gcp.endpoints.ConsumersIamPolicy: Authoritative. Sets the IAM policy for the serviceconsumers and replaces any existing policy already attached.
  • gcp.endpoints.ConsumersIamBinding: 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 serviceconsumers are preserved. Members added outside of Terraform for the same role will be detected as drift and removed on the next pulumi up.
  • gcp.endpoints.ConsumersIamMember: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the serviceconsumers 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.endpoints.ConsumersIamPolicy: Retrieves the IAM policy for the serviceconsumers

> Note: gcp.endpoints.ConsumersIamPolicy cannot be used in conjunction with gcp.endpoints.ConsumersIamBinding and gcp.endpoints.ConsumersIamMember or they will fight over what your policy should be.

> Note: gcp.endpoints.ConsumersIamBinding resources can be used in conjunction with gcp.endpoints.ConsumersIamMember resources only if they do not grant privilege to the same role.

gcp.endpoints.ConsumersIamPolicy

Import

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

  • services/{{service_name}}/consumers/{{consumer_project}}
  • {{service_name}}/{{consumer_project}}
  • {{consumer_project}}

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

Cloud Endpoints serviceconsumers 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_endpoints_service_consumers_iam_member.editor "services/{{service_name}}/consumers/{{consumer_project}} roles/servicemanagement.serviceController user:jane@example.com"

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

$ terraform import google_endpoints_service_consumers_iam_binding.editor "services/{{service_name}}/consumers/{{consumer_project}} roles/servicemanagement.serviceController"

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

$ pulumi import gcp:endpoints/consumersIamMember:ConsumersIamMember editor services/{{service_name}}/consumers/{{consumer_project}}

> 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

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

Properties

childResources → Set<Resource>
finalinherited
completionSources ↔ Map<String, IOutputCompletionSource>
latefinalinherited
condition ↔ Output<ConsumersIamMemberCondition?>
latefinal
consumerProject ↔ Output<String>
Used to find the parent resource to bind the IAM policy to
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
member ↔ Output<String>
Identities that will be granted the privilege in role. Each entry can have one of the following values:
latefinal
resourceTransforms → List<ResourceTransform>
Inherited/explicit async transforms.
no setterinherited
role ↔ Output<String>
The role that should be applied. Only one gcp.endpoints.ConsumersIamBinding 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
serviceName ↔ Output<String>
The name of the service. Used to find the parent resource to bind the IAM policy to
latefinal
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, {ConsumersIamMemberState? state, CustomResourceOptions? options}) → ConsumersIamMember
Gets an existing ConsumersIamMember resource's state with the given name and id.