hcp projects iam set-policy

Command: hcp projects iam set-policy

The hcp projects iam set-policy command sets the IAM policy for the project, given a project ID and a file encoded in JSON that contains the IAM policy. If adding or removing a single principal from the policy, prefer using hcp projects iam add-binding and the related hcp projects iam delete-binding.

The policy file is expected to be a file encoded in JSON that contains the IAM policy.

The format for the policy JSON file is an object with the following format:

{  "bindings": [    {      "role_id": "ROLE_ID",      "members": [        {          "member_id": "PRINCIPAL_ID",          "member_type": "USER" | "GROUP" | "SERVICE_PRINCIPAL"        }      ]    }  ],  "etag": "ETAG"}

If set, the etag of the policy must be equal to that of the existing policy. To view the existing policy and its etag, run hcp projects iam read-policy --format=json. If unset, the existing policy's etag will be fetched and used.

Usage

$ hcp projects iam set-policy --policy-file=PATH [Optional Flags]

Examples

Set the IAM Policy for a project:

$ cat >policy.json <<EOF{  "bindings": [    {      "role_id": "roles/viewer",      "members": [      {        "member_id": "97e2c752-4285-419e-a5cc-bf05ce811d7d",        "member_type": "USER"      },      {        "member_id": "334514c1-4650-4699-891a-a7261fba9607",        "member_type": "GROUP"      }    ]  },  {    "role_id": "roles/admin",    "members": [      {        "member_id": "efa07942-17e8-4ef4-ae2d-ec51d32a0767",        "member_type": "SERVICE_PRINCIPAL"      }    ]  }  ],  "etag": "14124142"}EOF$ hcp projects iam set-policy \  --policy-file=policy.json \  --project=8647ae06-ca65-467a-b72d-edba1f908fc8

Required flags

• --policy-file=PATH - The path to a file containing an IAM policy object.