Cisco Intersight Aaa API

The aaa API from Cisco Intersight — 6 operation(s) for aaa.

Operations 9

GET /api/v1/aaa/AuditRecords Read a 'aaa.AuditRecord' resource. #
GET /api/v1/aaa/AuditRecords/{Moid} Read a 'aaa.AuditRecord' resource. #
GET /api/v1/aaa/RetentionConfigs Read a 'aaa.RetentionConfig' resource. #
GET /api/v1/aaa/RetentionConfigs/{Moid} Read a 'aaa.RetentionConfig' resource. #
GET /api/v1/aaa/RetentionPolicies Read a 'aaa.RetentionPolicy' resource. #
POST /api/v1/aaa/RetentionPolicies Create a 'aaa.RetentionPolicy' resource. #
GET /api/v1/aaa/RetentionPolicies/{Moid} Read a 'aaa.RetentionPolicy' resource. #
POST /api/v1/aaa/RetentionPolicies/{Moid} Update a 'aaa.RetentionPolicy' resource. #
PATCH /api/v1/aaa/RetentionPolicies/{Moid} Update a 'aaa.RetentionPolicy' resource. #

Documentation

Specifications

Other Resources

🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-fabric-v3-1.0.11-20260807064027971.json
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/intersight/refs/heads/main/conventions/intersight-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/intersight/refs/heads/main/errors/intersight-problem-types.yml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/intersight/refs/heads/main/scopes/intersight-scopes.yml
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-hyperflex-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-kubernetes-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-nexus-insight-advisor-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-orchestrator-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-server-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-storage-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-system-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-telemetry-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-virtualization-v3-1.0.11-20260807064027971.json
🔗
OpenAPI Source
https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-workflows-v3-1.0.11-20260807064027971.json
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/intersight/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/intersight-aaa-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

intersight-aaa-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Intersight Aaa API
  version: 1.0.11-20260807064027971
  contact:
    name: Intersight API support
    url: https://intersight.com/help
    email: intersight@cisco.com
  license:
    name: Apache License, Version 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  x-evidence:
  - type: source
    url: https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-openapi-v3-1.0.11-20260807064027971.json
  - type: source
    url: https://intersight.com/apidocs/apirefs/
  x-provenance:
    method: harvested
    authored_by: Cisco Intersight
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    provider_published: true
    source_host: cdn.intersight.com
    note: Cisco publishes the full Intersight OpenAPI 3.0.2 anonymously from its CDN (27.5MB master document; 3,963 operations / 2,448 paths / 5,612 schemas) plus 11 per-service documents covering 100% of the master's paths. Byte-identity reconfirmed 2026-08-19 by SHA-256. Note intersight.com itself is a soft-404 farm — the contract is on the CDN, not the app host.
  description: 'Operations tagged aaa across 2 of this provider''s published API definitions: intersight-system-openapi.json, intersight-workflows-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{server}
  variables:
    server:
      default: intersight.com
  description: The Intersight URL for the cloud-based infrastructure management APIs.
tags:
- name: aaa
paths:
  /api/v1/aaa/AuditRecords:
    get:
      tags:
      - aaa
      summary: Read a 'aaa.AuditRecord' resource.
      operationId: GetAaaAuditRecordList
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Monitor audit logs
        - PRIVSET.Read-only all audit logs
        - PRIVSET.View Audit Logs
        - READ.aaa.AuditRecord
        - ROLE.Account Administrator
      parameters:
      - $ref: '#/components/parameters/filterParam'
      - $ref: '#/components/parameters/orderbyParam'
      - $ref: '#/components/parameters/topParam'
      - $ref: '#/components/parameters/skipParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/applyParam'
      - $ref: '#/components/parameters/countParam'
      - $ref: '#/components/parameters/inlinecountParam'
      - $ref: '#/components/parameters/atParam'
      - $ref: '#/components/parameters/tagsParam'
      responses:
        '200':
          description: List of 'aaa.AuditRecord' resources for the given filter criteria
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.AuditRecord.Response'
            text/csv:
              schema:
                $ref: '#/components/schemas/CsvFile'
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: '#/components/schemas/ExcelFile'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    servers:
    - url: https://{server}
      variables:
        server:
          default: intersight.com
      description: The Intersight URL for the cloud-based infrastructure management APIs.
  /api/v1/aaa/AuditRecords/{Moid}:
    get:
      tags:
      - aaa
      summary: Read a 'aaa.AuditRecord' resource.
      operationId: GetAaaAuditRecordByMoid
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Monitor audit logs
        - PRIVSET.Read-only all audit logs
        - PRIVSET.View Audit Logs
        - READ.aaa.AuditRecord
        - ROLE.Account Administrator
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/atParam'
      responses:
        '200':
          description: An instance of the 'aaa.AuditRecord' resource.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.AuditRecord'
            text/csv:
              schema:
                $ref: '#/components/schemas/CsvFile'
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: '#/components/schemas/ExcelFile'
          links:
            GetAaaAuditRecordByMoid:
              operationId: GetAaaAuditRecordByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/aaa/AuditRecords/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    servers:
    - url: https://{server}
      variables:
        server:
          default: intersight.com
      description: The Intersight URL for the cloud-based infrastructure management APIs.
  /api/v1/aaa/RetentionConfigs:
    get:
      tags:
      - aaa
      summary: Read a 'aaa.RetentionConfig' resource.
      operationId: GetAaaRetentionConfigList
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Configure account details
        - PRIVSET.Monitor audit logs
        - PRIVSET.Read-Only
        - PRIVSET.View Audit Logs
        - READ.aaa.RetentionConfig
        - ROLE.Account Administrator
        - ROLE.Read-Only
      parameters:
      - $ref: '#/components/parameters/filterParam'
      - $ref: '#/components/parameters/orderbyParam'
      - $ref: '#/components/parameters/topParam'
      - $ref: '#/components/parameters/skipParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/applyParam'
      - $ref: '#/components/parameters/countParam'
      - $ref: '#/components/parameters/inlinecountParam'
      - $ref: '#/components/parameters/atParam'
      - $ref: '#/components/parameters/tagsParam'
      responses:
        '200':
          description: List of 'aaa.RetentionConfig' resources for the given filter criteria
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.RetentionConfig.Response'
            text/csv:
              schema:
                $ref: '#/components/schemas/CsvFile'
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: '#/components/schemas/ExcelFile'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    servers:
    - url: https://{server}
      variables:
        server:
          default: intersight.com
      description: The Intersight URL for the cloud-based infrastructure management APIs.
  /api/v1/aaa/RetentionConfigs/{Moid}:
    get:
      tags:
      - aaa
      summary: Read a 'aaa.RetentionConfig' resource.
      operationId: GetAaaRetentionConfigByMoid
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Configure account details
        - PRIVSET.Monitor audit logs
        - PRIVSET.Read-Only
        - PRIVSET.View Audit Logs
        - READ.aaa.RetentionConfig
        - ROLE.Account Administrator
        - ROLE.Read-Only
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/atParam'
      responses:
        '200':
          description: An instance of the 'aaa.RetentionConfig' resource.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.RetentionConfig'
            text/csv:
              schema:
                $ref: '#/components/schemas/CsvFile'
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: '#/components/schemas/ExcelFile'
          links:
            GetAaaRetentionConfigByMoid:
              operationId: GetAaaRetentionConfigByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/aaa/RetentionConfigs/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    servers:
    - url: https://{server}
      variables:
        server:
          default: intersight.com
      description: The Intersight URL for the cloud-based infrastructure management APIs.
  /api/v1/aaa/RetentionPolicies:
    get:
      tags:
      - aaa
      summary: Read a 'aaa.RetentionPolicy' resource.
      operationId: GetAaaRetentionPolicyList
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Configure account details
        - PRIVSET.Monitor audit logs
        - PRIVSET.Read-Only
        - PRIVSET.Read-only all audit logs
        - PRIVSET.View Audit Logs
        - READ.aaa.RetentionPolicy
        - ROLE.Account Administrator
        - ROLE.Read-Only
      parameters:
      - $ref: '#/components/parameters/filterParam'
      - $ref: '#/components/parameters/orderbyParam'
      - $ref: '#/components/parameters/topParam'
      - $ref: '#/components/parameters/skipParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/applyParam'
      - $ref: '#/components/parameters/countParam'
      - $ref: '#/components/parameters/inlinecountParam'
      - $ref: '#/components/parameters/atParam'
      - $ref: '#/components/parameters/tagsParam'
      responses:
        '200':
          description: List of 'aaa.RetentionPolicy' resources for the given filter criteria
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.RetentionPolicy.Response'
            text/csv:
              schema:
                $ref: '#/components/schemas/CsvFile'
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: '#/components/schemas/ExcelFile'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    post:
      tags:
      - aaa
      summary: Create a 'aaa.RetentionPolicy' resource.
      operationId: CreateAaaRetentionPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - CREATE.aaa.RetentionPolicy
        - PRIVSET.Account Administrator
        - PRIVSET.Configure account details
        - ROLE.Account Administrator
      parameters:
      - $ref: '#/components/parameters/IfMatch'
      - $ref: '#/components/parameters/IfNoneMatch'
      requestBody:
        description: The 'aaa.RetentionPolicy' resource to create.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/aaa.RetentionPolicy'
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'aaa.RetentionPolicy' resource was created as requested. The 'aaa.RetentionPolicy' resource is created before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.RetentionPolicy'
          links:
            GetAaaRetentionPolicyByMoid:
              operationId: GetAaaRetentionPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/aaa/RetentionPolicies/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    servers:
    - url: https://{server}
      variables:
        server:
          default: intersight.com
      description: The Intersight URL for the cloud-based infrastructure management APIs.
  /api/v1/aaa/RetentionPolicies/{Moid}:
    get:
      tags:
      - aaa
      summary: Read a 'aaa.RetentionPolicy' resource.
      operationId: GetAaaRetentionPolicyByMoid
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Configure account details
        - PRIVSET.Monitor audit logs
        - PRIVSET.Read-Only
        - PRIVSET.Read-only all audit logs
        - PRIVSET.View Audit Logs
        - READ.aaa.RetentionPolicy
        - ROLE.Account Administrator
        - ROLE.Read-Only
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/atParam'
      responses:
        '200':
          description: An instance of the 'aaa.RetentionPolicy' resource.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.RetentionPolicy'
            text/csv:
              schema:
                $ref: '#/components/schemas/CsvFile'
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: '#/components/schemas/ExcelFile'
          links:
            GetAaaRetentionPolicyByMoid:
              operationId: GetAaaRetentionPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/aaa/RetentionPolicies/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    post:
      tags:
      - aaa
      summary: Update a 'aaa.RetentionPolicy' resource.
      operationId: UpdateAaaRetentionPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Configure account details
        - ROLE.Account Administrator
        - UPDATE.aaa.RetentionPolicy
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/IfMatch'
      requestBody:
        description: The 'aaa.RetentionPolicy' resource to update.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/aaa.RetentionPolicy'
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/PatchDocument'
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'aaa.RetentionPolicy' resource was modified as requested. The 'aaa.RetentionPolicy' resource is modified before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.RetentionPolicy'
          links:
            GetAaaRetentionPolicyByMoid:
              operationId: GetAaaRetentionPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/aaa/RetentionPolicies/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    patch:
      tags:
      - aaa
      summary: Update a 'aaa.RetentionPolicy' resource.
      operationId: PatchAaaRetentionPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Configure account details
        - ROLE.Account Administrator
        - UPDATE.aaa.RetentionPolicy
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/IfMatch'
      requestBody:
        description: The 'aaa.RetentionPolicy' resource to update.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/aaa.RetentionPolicy'
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/PatchDocument'
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'aaa.RetentionPolicy' resource was patched as requested. The 'aaa.RetentionPolicy' resource is patched before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/aaa.RetentionPolicy'
          links:
            GetAaaRetentionPolicyByMoid:
              operationId: GetAaaRetentionPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/aaa/RetentionPolicies/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    servers:
    - url: https://{server}
      variables:
        server:
          default: intersight.com
      description: The Intersight URL for the cloud-based infrastructure management APIs.
components:
  headers:
    x-starship-traceid:
      description: A value that uniquely identifies a HTTP request and its response.
      schema:
        type: string
    Set-Cookie:
      description: Cookie authentication key for use with the `cookieAuth` apiKey authentication.
      schema:
        type: string
        example: X-Starship-Token=abcde12345; Path=/
    Content-Length:
      description: Indicates the size of the entity-body, in bytes, sent to the recipient.
      schema:
        type: integer
    Content-Disposition:
      description: If not present, indicates the response content is expected to be displayed inline in the browser, that is, as a Web page or as part of a Web page. If present, indicates the response content is expected to be an attachment, that is downloaded and saved locally.
      schema:
        type: string
  schemas:
    pkix.KeyGenerationSpec:
      title: Pkix:Key Generation Spec
      description: The key generation spec provides the algorithm and the parameters required for this algorithm to generate a key.
      x-allOf-name: pkix.KeyGenerationSpec
      allOf:
      - $ref: '#/components/schemas/mo.BaseComplexType'
      - type: object
        description: Definition of the list of properties defined in 'pkix.KeyGenerationSpec', excluding properties defined in parent classes.
        required:
        - ClassId
        - ObjectType
        properties:
          ClassId:
            description: 'The fully-qualified name of the instantiated, concrete type.

              This property is used as a discriminator to identify the type of the payload

              when marshaling and unmarshaling data.

              The enum values provides the list of concrete types that can be instantiated from this abstract type.'
            enum:
            - pkix.EcdsaKeySpec
            - pkix.EddsaKeySpec
            - pkix.RsaAlgorithm
            x-enum-as-string: true
          ObjectType:
            description: 'The fully-qualified name of the instantiated, concrete type.

              The value should be the same as the ''ClassId'' property.

              The enum values provides the list of concrete types that can be instantiated from this abstract type.'
            enum:
            - pkix.EcdsaKeySpec
            - pkix.EddsaKeySpec
            - pkix.RsaAlgorithm
            x-enum-as-string: true
          Name:
            description: 'Name of the key generation algorithm.

              * `RSA` - Key pairs should be generated by the RSA algorithm.'
            type: string
            enum:
            - RSA
            default: RSA
            readOnly: true
            x-omitempty: true
    policy.AbstractPolicy.Relationship:
      description: A relationship to the 'policy.AbstractPolicy' resource, or the expanded 'policy.AbstractPolicy' resource, or the 'null' value.
      x-one-of-name: policy.AbstractPolicy.Relationship
      oneOf:
      - type: 'null'
      - $ref: '#/components/schemas/mo.MoRef'
      - $ref: '#/components/schemas/policy.AbstractPolicy'
      discriminator:
        propertyName: ClassId
    iam.System.Relationship:
      description: A relationship to the 'iam.System' resource, or the expanded 'iam.System' resource, or the 'null' value.
      x-one-of-name: iam.System.Relationship
      oneOf:
      - type: 'null'
      - $ref: '#/components/schemas/mo.MoRef'
      - $ref: '#/components/schemas/iam.System'
      discriminator:
        propertyName: ClassId
    mo.BaseMo.Relationship:
      description: A relationship to the 'mo.BaseMo' resource, or the expanded 'mo.BaseMo' resource, or the 'null' value.
      x-one-of-name: mo.BaseMo.Relationship
      oneOf:
      - type: 'null'
      - $ref: '#/components/schemas/mo.MoRef'
      - $ref: '#/components/schemas/mo.BaseMo'
      discriminator:
        propertyName: ClassId
    iam.ResourceRoles.Relationship:
      description: A relationship to the 'iam.ResourceRoles' resource, or the expanded 'iam.ResourceRoles' resource, or the 'null' value.
      x-one-of-name: iam.ResourceRoles.Relationship
      oneOf:
      - type: 'null'
      - $ref: '#/components/schemas/mo.MoRef'
      - $ref: '#/components/schemas/iam.ResourceRoles'
      discriminator:
        propertyName: ClassId
    aaa.AuditRecord.List:
      title: List of 'aaa.AuditRecord' resources
      description: This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
      allOf:
      - $ref: '#/components/schemas/mo.BaseResponse'
      - type: object
        properties:
          Count:
            description: 'The total number of ''aaa.AuditRecord'' resources matching the request, accross all pages.

              The ''Count'' attribute is included when the HTTP GET request includes the ''$inlinecount'' parameter.'
            type: integer
            format: int32
          Results:
            description: The array of 'aaa.AuditRecord' resources matching the request.
            type:
            - array
            - 'null'
            items:
              $ref: '#/components/schemas/aaa.AuditRecord'
    iam.SwitchAccountPermission:
      title: Iam:Switch Account Permission
      description: SwitchScope parameters related to the Account to/from which user switched.
      x-allOf-name: iam.SwitchAccountPermission
      allOf:
      - $ref: '#/components/schemas/mo.BaseComplexType'
      - type: object
        description: Definition of the list of properties defined in 'iam.SwitchAccountPermission', excluding properties defined in parent classes.
        required:
        - ClassId
        - ObjectType
        properties:
          ClassId:
            description: 'The fully-qualified name of the instantiated, concrete type.

              This property is used as a discriminator to identify the type of the payload

              when marshaling and unmarshaling data.'
            enum:
            - iam.SwitchAccountPermission
            default: iam.SwitchAccountPermission
            x-enum-as-string: true
          ObjectType:
            description: 'The fully-qualified name of the instantiated, concrete type.

              The value should be the same as the ''ClassId'' property.'
            enum:
            - iam.SwitchAccountPermission
            default: iam.SwitchAccountPermission
            x-enum-as-string: true
          AccountId:
            description: Moid of the Account to/from which user switched the scope.
            type: string
            readOnly: true
            x-omitempty: true
          PermissionId:
            description: Moid of the Permission for the Account to/from which user switched the scope.
            type: string
            readOnly: true
            x-omitempty: true
    iam.EndPointPrivilege:
      title: Iam:End Point Privilege
      description: 'EndPointPrivilege models privileges defined on managed endpoints (e.g., UCS, IMC), enabling cross-launch or delegated actions.

        #### Purpose

        It exposes endpoint-side authorization elements that can be assigned to platform users via endpoint roles.

        #### Key Concepts

        - **Endpoint Integration:** Bridges device-level capabilities to platform users.

        - **Read-only Catalog:** Reflects endpoint-defined actions.

        - **Role Assignment:** Consumed by EndPointRole for user access.'
      x-allOf-name: iam.EndPointPrivilege
      allOf:
      - $ref: '#/components/schemas/mo.BaseMo'
      - type: object
        description: Definition of the list of properties defined in 'iam.EndPointPrivilege', excluding properties defined in parent classes.
        required:
        - ClassId
        - ObjectType
        properties:
          ClassId:
            description: 'The fully-qualified name of the instantiated, concrete type.

              This property is used as a discriminator to identify the type of the payload

              when marshaling and unmarshaling data.'
            enum:
            - iam.EndPointPrivilege
            default: iam.EndPointPrivilege
            x-enum-as-string: true
          ObjectType:
            description: 'The fully-qualified name of the instantiated, concrete type.

              The value should be the same as the ''ClassId'' property.'
            enum:
            - iam.EndPointPrivilege
            default: iam.EndPointPrivilege
            x-enum-as-string: t

# --- truncated at 32 KB (1189 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/intersight/refs/heads/main/openapi/intersight-aaa-api-openapi.yml