Method: getEffectiveMcpPolicy

Get effective MCP consumer policy for a resource, which contains enable rule information of MCP consumer policies from the resource hierarchy.

HTTP request

GET https://serviceusage.googleapis.com/v2beta/{name=*/*/effectiveMcpPolicy}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the effective policy to retrieve. Format: projects/100/effectiveMcpPolicy, folders/101/effectiveMcpPolicy, organizations/102/effectiveMcpPolicy.

Query parameters

Parameters
view

enum (EffectiveMcpPolicyView)

The view of the effective MCP policy to use.

Request body

The request body must be empty.

Response body

Effective MCP Policy is a singleton read-only resource modeling the collapsed policies and metadata effective at a particular point in the hierarchy.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "name": string,
  "updateTime": string,
  "mcpEnableRules": [
    {
      object (McpEnableRule)
    }
  ],
  "mcpEnableRuleMetadata": [
    {
      object (McpRuleSource)
    }
  ]
}
Fields
name

string

Output only. The name of the effective MCP policy. Format: projects/100/effectiveMcpPolicy, folders/101/effectiveMcpPolicy, organizations/102/effectiveMcpPolicy.
updateTime

string (Timestamp format)

Output only. The time the effective MCP policy was last updated.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
mcpEnableRules[]

object (McpEnableRule)

Output only. Aggregated McpEnableRule objects grouped by any associated conditions.

Conditions are not supported in beta and there will be exactly one rule present.
mcpEnableRuleMetadata[]

object (McpRuleSource)

Output only. Metadata about mcp enable rules in the same order as the mcpEnableRules objects.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

EffectiveMcpPolicyView

The view of the effective MCP policy.

Enums
EFFECTIVE_MCP_POLICY_VIEW_UNSPECIFIED The default / unset value. The API will default to the BASIC view.
EFFECTIVE_MCP_POLICY_VIEW_BASIC Include basic metadata about the effective MCP policy, but not the source of policy rules. This is the default value.
EFFECTIVE_MCP_POLICY_VIEW_FULL Include everything.

McpRuleSource

McpRuleSource contains source information for where a MCP rule was found.

JSON representation 
{
  "serviceSources": {
    string: {
      object (McpPolicyList)
    },
    ...
  }
}
Fields
serviceSources

map (key: string, value: object (McpPolicyList))

Map of MCP enabled services as keys and the policy that enabled it as values. For example, the key can be services/serviceusage.googleapis.com and value can be {"projects/123/mcpPolicies/default", "folders/456/mcpPolicies/default"} where the service is enabled and the order of the resource list is nearest first in the hierarchy.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

McpPolicyList

McpPolicyList contains MCP policy resources in the hierarchy ordered from leaf to root.

JSON representation 
{
  "policies": [
    string
  ]
}
Fields
policies[]

string

List of MCP policy resources ordered from leaf to root.