v27

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-01304498.9 KB
policies

Get policy details

Returns detailed information about a specific policy, including the MaaSAuthPolicy resource and related MaaSModelRef summaries. K8s calls: GET /k8s/v1/maasauthpolicy/:name, GET /k8s/v1/maasmodelref

get/api/v1/view-policy/{name}

Path parameters

namestring required

Name of the MaaSAuthPolicy resource

Response

Policy details with related model refs

Example response

{
  "policy": {
    "name": "premium-team-sub-policy",
    "namespace": "maas-system",
    "displayName": "Premium Team Policy",
    "description": "High-priority access policy for the premium team.",
    "phase": "Active",
    "statusMessage": "successfully reconciled",
    "creationTimestamp": "2025-03-01T10:00:00Z",
    "modelRefs": [
      {
        "name": "llama-2-7b-chat",
        "namespace": "maas-models"
      }
    ],
    "subjects": {
      "groups": [
        {
          "name": "premium-users"
        }
      ]
    },
    "meteringMetadata": {
      "organizationId": "org-123",
      "costCenter": "engineering"
    }
  },
  "modelRefs": [
    {
      "name": "llama-2-7b-chat",
      "namespace": "maas-models",
      "displayName": "Granite 3 8B Instruct",
      "description": "IBM Granite 3 8B instruction-tuned language model.",
      "modelRef": {
        "kind": "LLMInferenceService",
        "name": "llama-2-7b-chat"
      },
      "phase": "Ready",
      "endpoint": "https://llama-2-7b-chat.example.com",
      "modelCapabilities": [
        "text-generation",
        "vision"
      ]
    }
  ]
}