{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-iam/json-schema/google-cloud-iam-google-cloud-policytroubleshooter-iam-v3-troubleshoot-iam-policy-request-schema.json",
  "title": "GoogleCloudPolicytroubleshooterIamV3TroubleshootIamPolicyRequest",
  "description": "Request for TroubleshootIamPolicy.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-iam-policytroubleshooter-iam-api-openapi.yml#/components/schemas/GoogleCloudPolicytroubleshooterIamV3TroubleshootIamPolicyRequest",
  "properties": {
    "accessTuple": {
      "$ref": "#/$defs/GoogleCloudPolicytroubleshooterIamV3AccessTuple",
      "description": "The information to use for checking whether a principal has a permission for a resource."
    }
  },
  "type": "object",
  "$defs": {
    "GoogleCloudPolicytroubleshooterIamV3AccessTuple": {
      "description": "Information about the principal, resource, and permission to check.",
      "type": "object",
      "properties": {
        "permission": {
          "type": "string",
          "description": "Required. The IAM permission to check for, either in the `v1` permission format or the `v2` permission format. For a complete list of IAM permissions in the `v1` format, see https://cloud.google.com/iam/help/permissions/reference. For a list of IAM permissions in the `v2` format, see https://cloud.google.com/iam/help/deny/supported-permissions. For a complete list of predefined IAM roles and the permissions in each role, see https://cloud.google.com/iam/help/roles/reference."
        },
        "principal": {
          "description": "Required. The email address of the principal whose access you want to check. For example, `alice@example.com` or `my-service-account@my-project.iam.gserviceaccount.com`. The principal must be a Google Account or a service account. Other types of principals are not supported.",
          "type": "string"
        },
        "permissionFqdn": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The permission that Policy Troubleshooter checked for, in the `v2` format."
        },
        "fullResourceName": {
          "type": "string",
          "description": "Required. The full resource name that identifies the resource. For example, `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance`. For examples of full resource names for Google Cloud services, see https://cloud.google.com/iam/help/troubleshooter/full-resource-names."
        },
        "conditionContext": {
          "$ref": "#/$defs/GoogleCloudPolicytroubleshooterIamV3ConditionContext",
          "description": "Optional. Additional context for the request, such as the request time or IP address. This context allows Policy Troubleshooter to troubleshoot conditional role bindings and deny rules."
        }
      }
    },
    "GoogleCloudPolicytroubleshooterIamV3ConditionContext": {
      "properties": {
        "effectiveTags": {
          "items": {
            "$ref": "#/$defs/GoogleCloudPolicytroubleshooterIamV3ConditionContextEffectiveTag"
          },
          "type": "array",
          "readOnly": true,
          "description": "Output only. The effective tags on the resource. The effective tags are fetched during troubleshooting."
        },
        "resource": {
          "$ref": "#/$defs/GoogleCloudPolicytroubleshooterIamV3ConditionContextResource",
          "description": "Represents a target resource that is involved with a network activity. If multiple resources are involved with an activity, this must be the primary one."
        },
        "destination": {
          "$ref": "#/$defs/GoogleCloudPolicytroubleshooterIamV3ConditionContextPeer",
          "description": "The destination of a network activity, such as accepting a TCP connection. In a multi-hop network activity, the destination represents the receiver of the last hop."
        },
        "request": {
          "$ref": "#/$defs/GoogleCloudPolicytroubleshooterIamV3ConditionContextRequest",
          "description": "Represents a network request, such as an HTTP request."
        }
      },
      "type": "object",
      "description": "Additional context for troubleshooting conditional role bindings and deny rules."
    },
    "GoogleCloudPolicytroubleshooterIamV3ConditionContextEffectiveTag": {
      "properties": {
        "namespacedTagKey": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The namespaced name of the TagKey. Can be in the form `{organization_id}/{tag_key_short_name}` or `{project_id}/{tag_key_short_name}` or `{project_number}/{tag_key_short_name}`."
        },
        "inherited": {
          "description": "Output only. Indicates the inheritance status of a tag value attached to the given resource. If the tag value is inherited from one of the resource's ancestors, inherited will be true. If false, then the tag value is directly attached to the resource, inherited will be false.",
          "readOnly": true,
          "type": "boolean"
        },
        "namespacedTagValue": {
          "readOnly": true,
          "description": "Output only. The namespaced name of the TagValue. Can be in the form `{organization_id}/{tag_key_short_name}/{tag_value_short_name}` or `{project_id}/{tag_key_short_name}/{tag_value_short_name}` or `{project_number}/{tag_key_short_name}/{tag_value_short_name}`.",
          "type": "string"
        },
        "tagKeyParentName": {
          "description": "The parent name of the tag key. Must be in the format `organizations/{organization_id}` or `projects/{project_number}`",
          "type": "string"
        },
        "tagKey": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The name of the TagKey, in the format `tagKeys/{id}`, such as `tagKeys/123`."
        },
        "tagValue": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. Resource name for TagValue in the format `tagValues/456`."
        }
      },
      "description": "A tag that applies to a resource during policy evaluation. Tags can be either directly bound to a resource or inherited from its ancestor. `EffectiveTag` contains the `name` and `namespaced_name` of the tag value and tag key, with additional fields of `inherited` to indicate the inheritance status of the effective tag.",
      "type": "object"
    },
    "GoogleCloudPolicytroubleshooterIamV3ConditionContextPeer": {
      "description": "This message defines attributes for a node that handles a network request. The node can be either a service or an application that sends, forwards, or receives the request. Service peers should fill in `principal` and `labels` as appropriate.",
      "properties": {
        "ip": {
          "description": "The IPv4 or IPv6 address of the peer.",
          "type": "string"
        },
        "port": {
          "format": "int64",
          "type": "string",
          "description": "The network port of the peer."
        }
      },
      "type": "object"
    },
    "GoogleCloudPolicytroubleshooterIamV3ConditionContextRequest": {
      "properties": {
        "receiveTime": {
          "description": "Optional. The timestamp when the destination service receives the first byte of the request.",
          "type": "string",
          "format": "google-datetime"
        }
      },
      "description": "This message defines attributes for an HTTP request. If the actual request is not an HTTP request, the runtime system should try to map the actual request to an equivalent HTTP request.",
      "type": "object"
    },
    "GoogleCloudPolicytroubleshooterIamV3ConditionContextResource": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "The stable identifier (name) of a resource on the `service`. A resource can be logically identified as `//{resource.service}/{resource.name}`. Unlike the resource URI, the resource name doesn't contain any protocol and version information. For a list of full resource name formats, see https://cloud.google.com/iam/help/troubleshooter/full-resource-names"
        },
        "service": {
          "description": "The name of the service that this resource belongs to, such as `compute.googleapis.com`. The service name might not match the DNS hostname that actually serves the request. For a full list of resource service values, see https://cloud.google.com/iam/help/conditions/resource-services",
          "type": "string"
        },
        "type": {
          "description": "The type of the resource, in the format `{service}/{kind}`. For a full list of resource type values, see https://cloud.google.com/iam/help/conditions/resource-types",
          "type": "string"
        }
      },
      "description": "Core attributes for a resource. A resource is an addressable (named) entity provided by the destination service. For example, a Compute Engine instance."
    }
  }
}