JobIAMBinding
Three different resources help you manage IAM policies on dataproc jobs. Each of these resources serves a different use case:
gcp.dataproc.JobIAMPolicy: Authoritative. Sets the IAM policy for the job and replaces any existing policy already attached.gcp.dataproc.JobIAMBinding: 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 job are preserved.gcp.dataproc.JobIAMMember: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the job are preserved.
Note:
gcp.dataproc.JobIAMPolicycannot be used in conjunction withgcp.dataproc.JobIAMBindingandgcp.dataproc.JobIAMMemberor they will fight over what your policy should be. In addition, be careful not to accidentally unset ownership of the job asgcp.dataproc.JobIAMPolicyreplaces the entire policy.Note:
gcp.dataproc.JobIAMBindingresources can be used in conjunction withgcp.dataproc.JobIAMMemberresources only if they do not grant privilege to the same role.
Create a JobIAMBinding Resource
new JobIAMBinding(name: string, args: JobIAMBindingArgs, opts?: CustomResourceOptions);def JobIAMBinding(resource_name, opts=None, condition=None, job_id=None, members=None, project=None, region=None, role=None, __props__=None);func NewJobIAMBinding(ctx *Context, name string, args JobIAMBindingArgs, opts ...ResourceOption) (*JobIAMBinding, error)public JobIAMBinding(string name, JobIAMBindingArgs args, CustomResourceOptions? opts = null)- name string
- The unique name of the resource.
- args JobIAMBindingArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- opts ResourceOptions
- A bag of options that control this resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args JobIAMBindingArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args JobIAMBindingArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
JobIAMBinding Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.
Inputs
The JobIAMBinding resource accepts the following input properties:
- Job
Id string - Members List<string>
- Role string
The role that should be applied. Only one
gcp.dataproc.JobIAMBindingcan be used per role. Note that custom roles must be of the format[projects|organizations]/{parent-name}/roles/{role-name}.- Condition
Job
IAMBinding Condition Args - Project string
The project in which the job belongs. If it is not provided, the provider will use a default.
- Region string
The region in which the job belongs. If it is not provided, the provider will use a default.
- Job
Id string - Members []string
- Role string
The role that should be applied. Only one
gcp.dataproc.JobIAMBindingcan be used per role. Note that custom roles must be of the format[projects|organizations]/{parent-name}/roles/{role-name}.- Condition
Job
IAMBinding Condition - Project string
The project in which the job belongs. If it is not provided, the provider will use a default.
- Region string
The region in which the job belongs. If it is not provided, the provider will use a default.
- job
Id string - members string[]
- role string
The role that should be applied. Only one
gcp.dataproc.JobIAMBindingcan be used per role. Note that custom roles must be of the format[projects|organizations]/{parent-name}/roles/{role-name}.- condition
Job
IAMBinding Condition - project string
The project in which the job belongs. If it is not provided, the provider will use a default.
- region string
The region in which the job belongs. If it is not provided, the provider will use a default.
- job_
id str - members List[str]
- role str
The role that should be applied. Only one
gcp.dataproc.JobIAMBindingcan be used per role. Note that custom roles must be of the format[projects|organizations]/{parent-name}/roles/{role-name}.- condition
Dict[Job
IAMBinding Condition] - project str
The project in which the job belongs. If it is not provided, the provider will use a default.
- region str
The region in which the job belongs. If it is not provided, the provider will use a default.
Outputs
All input properties are implicitly available as output properties. Additionally, the JobIAMBinding resource produces the following output properties:
Look up an Existing JobIAMBinding Resource
Get an existing JobIAMBinding resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: JobIAMBindingState, opts?: CustomResourceOptions): JobIAMBindingstatic get(resource_name, id, opts=None, condition=None, etag=None, job_id=None, members=None, project=None, region=None, role=None, __props__=None);func GetJobIAMBinding(ctx *Context, name string, id IDInput, state *JobIAMBindingState, opts ...ResourceOption) (*JobIAMBinding, error)public static JobIAMBinding Get(string name, Input<string> id, JobIAMBindingState? state, CustomResourceOptions? opts = null)- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
The following state arguments are supported:
- Condition
Job
IAMBinding Condition Args - Etag string
(Computed) The etag of the jobs’s IAM policy.
- Job
Id string - Members List<string>
- Project string
The project in which the job belongs. If it is not provided, the provider will use a default.
- Region string
The region in which the job belongs. If it is not provided, the provider will use a default.
- Role string
The role that should be applied. Only one
gcp.dataproc.JobIAMBindingcan be used per role. Note that custom roles must be of the format[projects|organizations]/{parent-name}/roles/{role-name}.
- Condition
Job
IAMBinding Condition - Etag string
(Computed) The etag of the jobs’s IAM policy.
- Job
Id string - Members []string
- Project string
The project in which the job belongs. If it is not provided, the provider will use a default.
- Region string
The region in which the job belongs. If it is not provided, the provider will use a default.
- Role string
The role that should be applied. Only one
gcp.dataproc.JobIAMBindingcan be used per role. Note that custom roles must be of the format[projects|organizations]/{parent-name}/roles/{role-name}.
- condition
Job
IAMBinding Condition - etag string
(Computed) The etag of the jobs’s IAM policy.
- job
Id string - members string[]
- project string
The project in which the job belongs. If it is not provided, the provider will use a default.
- region string
The region in which the job belongs. If it is not provided, the provider will use a default.
- role string
The role that should be applied. Only one
gcp.dataproc.JobIAMBindingcan be used per role. Note that custom roles must be of the format[projects|organizations]/{parent-name}/roles/{role-name}.
- condition
Dict[Job
IAMBinding Condition] - etag str
(Computed) The etag of the jobs’s IAM policy.
- job_
id str - members List[str]
- project str
The project in which the job belongs. If it is not provided, the provider will use a default.
- region str
The region in which the job belongs. If it is not provided, the provider will use a default.
- role str
The role that should be applied. Only one
gcp.dataproc.JobIAMBindingcan be used per role. Note that custom roles must be of the format[projects|organizations]/{parent-name}/roles/{role-name}.
Supporting Types
JobIAMBindingCondition
Package Details
- Repository
- https://github.com/pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-betaTerraform Provider.