Method: getEffectiveMcpPolicy

HTTP request
Path parameters
Query parameters
Request body
Response body
- JSON representation
Authorization scopes
EffectiveMcpPolicyView
McpRuleSource
- JSON representation
McpPolicyList
- JSON representation

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

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

name

string

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

Query parameters

Parameters

Parameters
`view`	`enum ( EffectiveMcpPolicyView )` The view of the effective MCP policy to use.

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

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" }` .

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 ] }