- release_tracks: [ALPHA, BETA, GA]

  help_text:
    brief: |
      Add IAM policy binding for a Cloud Deploy delivery pipeline.
    description: |
      Adds a policy binding to the IAM policy of a Cloud Deploy delivery
      pipeline. 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/clouddeploy.operator'
      for the user 'test-user@gmail.com' on 'my-pipeline' with the region
      'us-central1', run:

        $ {command} my-pipeline \
          --region='us-central1' \
          --member='user:test-user@gmail.com' \
          --role='roles/clouddeploy.operator'

  request:
    api_version: v1
    collection: clouddeploy.projects.locations.deliveryPipelines

  arguments:
    resource:
      help_text: The delivery pipeline for which to add the IAM policy binding.
      spec: !REF googlecloudsdk.command_lib.deploy.resources:delivery_pipeline
      is_positional: true

  iam:
    enable_condition: true
    policy_version: 3
    get_iam_policy_version_path: options_requestedPolicyVersion