Class FunctionIamPolicy
Three different resources help you manage your IAM policy for Cloud Functions CloudFunction. Each of these resources serves a different use case:
gcp.cloudfunctions.FunctionIamPolicy: Authoritative. Sets the IAM policy for the cloudfunction and replaces any existing policy already attached.gcp.cloudfunctions.FunctionIamBinding: 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 cloudfunction are preserved.gcp.cloudfunctions.FunctionIamMember: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the cloudfunction are preserved.
Note:
gcp.cloudfunctions.FunctionIamPolicycannot be used in conjunction withgcp.cloudfunctions.FunctionIamBindingandgcp.cloudfunctions.FunctionIamMemberor they will fight over what your policy should be.
Note:
gcp.cloudfunctions.FunctionIamBindingresources can be used in conjunction withgcp.cloudfunctions.FunctionIamMemberresources only if they do not grant privilege to the same role.
google_cloudfunctions_function_iam_policy
using Pulumi;
using Gcp = Pulumi.Gcp;
class MyStack : Stack
{
public MyStack()
{
var admin = Output.Create(Gcp.Organizations.GetIAMPolicy.InvokeAsync(new Gcp.Organizations.GetIAMPolicyArgs
{
Binding =
{
{
{ "role", "roles/viewer" },
{ "members",
{
"user:jane@example.com",
} },
},
},
}));
var policy = new Gcp.CloudFunctions.FunctionIamPolicy("policy", new Gcp.CloudFunctions.FunctionIamPolicyArgs
{
Project = google_cloudfunctions_function.Function.Project,
Region = google_cloudfunctions_function.Function.Region,
CloudFunction = google_cloudfunctions_function.Function.Name,
PolicyData = admin.Apply(admin => admin.PolicyData),
});
}
}
google_cloudfunctions_function_iam_binding
using Pulumi;
using Gcp = Pulumi.Gcp;
class MyStack : Stack
{
public MyStack()
{
var binding = new Gcp.CloudFunctions.FunctionIamBinding("binding", new Gcp.CloudFunctions.FunctionIamBindingArgs
{
Project = google_cloudfunctions_function.Function.Project,
Region = google_cloudfunctions_function.Function.Region,
CloudFunction = google_cloudfunctions_function.Function.Name,
Role = "roles/viewer",
Members =
{
"user:jane@example.com",
},
});
}
}
google_cloudfunctions_function_iam_member
using Pulumi;
using Gcp = Pulumi.Gcp;
class MyStack : Stack
{
public MyStack()
{
var member = new Gcp.CloudFunctions.FunctionIamMember("member", new Gcp.CloudFunctions.FunctionIamMemberArgs
{
Project = google_cloudfunctions_function.Function.Project,
Region = google_cloudfunctions_function.Function.Region,
CloudFunction = google_cloudfunctions_function.Function.Name,
Role = "roles/viewer",
Member = "user:jane@example.com",
});
}
}
Inherited Members
Namespace: Pulumi.Gcp.CloudFunctions
Assembly: Pulumi.Gcp.dll
Syntax
public class FunctionIamPolicy : CustomResource
Constructors
View SourceFunctionIamPolicy(String, FunctionIamPolicyArgs, CustomResourceOptions)
Create a FunctionIamPolicy resource with the given unique name, arguments, and options.
Declaration
public FunctionIamPolicy(string name, FunctionIamPolicyArgs args, CustomResourceOptions options = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | name | The unique name of the resource |
| FunctionIamPolicyArgs | args | The arguments used to populate this resource's properties |
| CustomResourceOptions | options | A bag of options that control this resource's behavior |
Properties
View SourceCloudFunction
Used to find the parent resource to bind the IAM policy to
Declaration
public Output<string> CloudFunction { get; }
Property Value
| Type | Description |
|---|---|
| Output<System.String> |
Etag
(Computed) The etag of the IAM policy.
Declaration
public Output<string> Etag { get; }
Property Value
| Type | Description |
|---|---|
| Output<System.String> |
PolicyData
The policy data generated by
a gcp.organizations.getIAMPolicy data source.
Declaration
public Output<string> PolicyData { get; }
Property Value
| Type | Description |
|---|---|
| Output<System.String> |
Project
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.
Declaration
public Output<string> Project { get; }
Property Value
| Type | Description |
|---|---|
| Output<System.String> |
Region
The location of this cloud function. 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 region is provided in the parent identifier and no region is specified, it is taken from the provider configuration.
Declaration
public Output<string> Region { get; }
Property Value
| Type | Description |
|---|---|
| Output<System.String> |
Methods
View SourceGet(String, Input<String>, FunctionIamPolicyState, CustomResourceOptions)
Get an existing FunctionIamPolicy resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
Declaration
public static FunctionIamPolicy Get(string name, Input<string> id, FunctionIamPolicyState state = null, CustomResourceOptions options = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | name | The unique name of the resulting resource. |
| Input<System.String> | id | The unique provider ID of the resource to lookup. |
| FunctionIamPolicyState | state | Any extra arguments used during the lookup. |
| CustomResourceOptions | options | A bag of options that control this resource's behavior |
Returns
| Type | Description |
|---|---|
| FunctionIamPolicy |