- release_tracks: [GA]

  help_text:
    brief: |
      Add IAM policy binding for a CA pool.
    description: |
      Adds a policy binding to the IAM policy of a CA pool. One binding
      consists of a member and a role.

      See https://cloud.google.com/iam/docs/managing-policies for details of
      the policy file format and contents.
    examples: |
      To add an IAM policy binding for the role of 'roles/privateca.certificateManager' for the user
      'test-user@gmail.com' on the CA pool 'my-pool' with the location 'us-west1', run:

        $ {command} my-pool \
          --location='us-west1' \
          --member='user:test-user@gmail.com' \
          --role='roles/privateca.certificateManager'

  request:
    collection: privateca.projects.locations.caPools
    api_version: v1

  arguments:
    resource:
      help_text: The CA pool for which to add the IAM policy binding.
      spec: !REF googlecloudsdk.command_lib.privateca.resources:ca_pool

  iam:
    enable_condition: true
    policy_version: 3
    get_iam_policy_version_path: options_requestedPolicyVersion