get_dynamic_group
Retrieve detailed information about a specific Oracle Cloud Infrastructure dynamic group, including matching rules for instance principals, by providing its OCID.
Instructions
Get detailed information about a specific dynamic group.
Args:
dynamic_group_id: OCID of the dynamic group to retrieve
Returns:
Detailed dynamic group information including matching rules for instance principalsInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dynamic_group_id | Yes |
Implementation Reference
- mcp_server_oci/tools/identity.py:273-302 (handler)Core handler function that executes the OCI API call to retrieve dynamic group details and formats the response.
def get_dynamic_group(identity_client: oci.identity.IdentityClient, dynamic_group_id: str) -> Dict[str, Any]: """ Get details of a specific dynamic group. Args: identity_client: OCI Identity client dynamic_group_id: OCID of the dynamic group Returns: Details of the dynamic group """ try: dynamic_group = identity_client.get_dynamic_group(dynamic_group_id).data dynamic_group_details = { "id": dynamic_group.id, "name": dynamic_group.name, "description": dynamic_group.description, "matching_rule": dynamic_group.matching_rule, "lifecycle_state": dynamic_group.lifecycle_state, "time_created": str(dynamic_group.time_created), "compartment_id": dynamic_group.compartment_id, } logger.info(f"Retrieved details for dynamic group {dynamic_group_id}") return dynamic_group_details except Exception as e: logger.exception(f"Error getting dynamic group details: {e}") raise - mcp_server_oci/mcp_server.py:1188-1205 (registration)MCP tool registration with @mcp.tool decorator, wrapper function that injects OCI client and handles errors/logging.
@mcp.tool(name="get_dynamic_group") @mcp_tool_wrapper( start_msg="Getting dynamic group details for {dynamic_group_id}...", success_msg="Retrieved dynamic group details successfully", error_prefix="Error getting dynamic group details" ) async def mcp_get_dynamic_group(ctx: Context, dynamic_group_id: str) -> Dict[str, Any]: """ Get detailed information about a specific dynamic group. Args: dynamic_group_id: OCID of the dynamic group to retrieve Returns: Detailed dynamic group information including matching rules for instance principals """ return get_dynamic_group(oci_clients["identity"], dynamic_group_id)