release_tracks: [ALPHA, BETA, GA]

help_text:
  brief: Set the IAM policy for a Compute Engine subnetwork.
  description: |
    Sets the IAM policy for the given subnetwork as defined in a JSON or YAML file.

  examples: |
    The following command will read am IAM policy defined in a JSON file
    'policy.json' and set it for the subnetwork `my-subnet`:

      $ {command} my-subnet policy.json --region=REGION

    See https://cloud.google.com/iam/docs/managing-policies for details of the
    policy file format and contents.

request:
  collection: compute.subnetworks
  use_relative_name: false
  modify_request_hooks:
  - googlecloudsdk.command_lib.iam.hooks:UseMaxRequestedPolicyVersion:api_field=regionSetPolicyRequest.policy.version
  api_version: v1
  BETA:
    api_version: beta
  ALPHA:
    api_version: alpha

iam:
  set_iam_policy_request_path: regionSetPolicyRequest
  message_type_overrides:
    policy: Policy
    set_iam_policy_request: ComputeSubnetworksSetIamPolicyRequest

arguments:
  resource:
    help_text: The subnetwork to set the IAM policy for.
    spec: !REF googlecloudsdk.command_lib.compute.resources:subnet
