Azure Storage Accounts Context Caches API

The ContextCaches API from Azure Storage Accounts — 4 operation(s) for contextcaches.

GitHub OpenAPI

Operations 7

POST /subscriptions/{subscriptionId}/providers/Microsoft.Storage/contextCacheCheckNameAvailability Context caches check name availability #
GET /subscriptions/{subscriptionId}/providers/Microsoft.Storage/contextCaches Context caches list by subscription #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/contextCaches Context caches list by resource group #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/contextCaches/{contextCacheName} Context caches get #
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/contextCaches/{contextCacheName} Context caches create or update #
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/contextCaches/{contextCacheName} Context caches update #
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/contextCaches/{contextCacheName} Context caches delete #

Documentation

Specifications

Schemas & Data

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/azure-storage-accounts:azure-storage-accounts-contextcaches-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

azure-storage-accounts-contextcaches-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: StorageManagementClient Context Caches API
  version: '2026-09-01'
  description: The Azure Storage Management API.
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: ContextCaches
paths:
  /subscriptions/{subscriptionId}/providers/Microsoft.Storage/contextCacheCheckNameAvailability:
    post:
      operationId: ContextCaches_CheckNameAvailability
      tags:
      - ContextCaches
      description: Check the availability of a context cache resource name.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextCacheCheckNameAvailabilityResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TypesErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContextCacheCheckNameAvailabilityParameters'
        description: The request body
        required: true
      summary: Context caches check name availability
      x-summary-source: derived
  /subscriptions/{subscriptionId}/providers/Microsoft.Storage/contextCaches:
    get:
      operationId: ContextCaches_ListBySubscription
      tags:
      - ContextCaches
      description: List Context Caches by subscription.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextCacheListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TypesErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Context caches list by subscription
      x-summary-source: derived
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/contextCaches:
    get:
      operationId: ContextCaches_ListByResourceGroup
      tags:
      - ContextCaches
      description: List Context Caches by resource group.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextCacheListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TypesErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Context caches list by resource group
      x-summary-source: derived
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/contextCaches/{contextCacheName}
  : get:
      operationId: ContextCaches_Get
      tags:
      - ContextCaches
      description: Get a Context Cache.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: contextCacheName
        in: path
        description: The name of the context cache
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,22}[a-z0-9]$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextCache'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TypesErrorResponse'
      summary: Context caches get
      x-summary-source: derived
    put:
      operationId: ContextCaches_CreateOrUpdate
      tags:
      - ContextCaches
      description: Create or update a Context Cache.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: contextCacheName
        in: path
        description: The name of the context cache
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,22}[a-z0-9]$
      responses:
        '200':
          description: Resource 'ContextCache' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextCache'
        '201':
          description: Resource 'ContextCache' create operation succeeded
          headers:
            Azure-AsyncOperation:
              description: A link to the status monitor
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextCache'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TypesErrorResponse'
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
        final-state-schema: '#/definitions/ContextCache'
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContextCache'
        description: Resource create parameters.
        required: true
      summary: Context caches create or update
      x-summary-source: derived
    patch:
      operationId: ContextCaches_Update
      tags:
      - ContextCaches
      description: Update a Context Cache.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: contextCacheName
        in: path
        description: The name of the context cache
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,22}[a-z0-9]$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextCache'
        '202':
          description: Resource update request accepted.
          headers:
            Location:
              description: The Location header contains the URL where the status of the long running operation can be checked.
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TypesErrorResponse'
      x-ms-long-running-operation-options:
        final-state-via: location
        final-state-schema: '#/definitions/ContextCache'
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContextCacheUpdate'
        description: The resource properties to be updated.
        required: true
      summary: Context caches update
      x-summary-source: derived
    delete:
      operationId: ContextCaches_Delete
      tags:
      - ContextCaches
      description: Delete a Context Cache.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: contextCacheName
        in: path
        description: The name of the context cache
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,22}[a-z0-9]$
      responses:
        '202':
          description: Resource deletion accepted.
          headers:
            Location:
              description: The Location header contains the URL where the status of the long running operation can be checked.
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
        '204':
          description: Resource does not exist.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TypesErrorResponse'
      x-ms-long-running-operation-options:
        final-state-via: location
      x-ms-long-running-operation: true
      summary: Context caches delete
      x-summary-source: derived
components:
  schemas:
    ContextCacheCheckNameAvailabilityFailureReason:
      type: string
      description: The reason why the context cache name is not available. The Reason element is only returned if NameAvailable is false.
      enum:
      - AlreadyExists
      - ContextCacheNameInvalid
      x-ms-enum:
        name: ContextCacheCheckNameAvailabilityFailureReason
        modelAsString: true
        values:
        - name: AlreadyExists
          value: AlreadyExists
          description: The context cache name is already in use.
        - name: ContextCacheNameInvalid
          value: ContextCacheNameInvalid
          description: The context cache name is invalid.
    ContextCacheUpdate:
      type: object
      description: The type used for update operations of the Context Cache.
      properties:
        tags:
          type: object
          description: Resource tags.
          additionalProperties:
            type: string
        identity:
          $ref: '#/components/schemas/ManagedServiceIdentity'
          description: The managed service identity.
        properties:
          $ref: '#/components/schemas/ContextCachePropertiesUpdate'
          description: The updatable properties of the Context Cache.
    Azure.ResourceManager.CommonTypes.InfrastructureEncryption:
      type: string
      description: (Optional) Discouraged to include in resource definition. Only needed where it is possible to disable platform (AKA infrastructure) encryption. Azure SQL TDE is an example of this. Values are enabled and disabled.
      enum:
      - enabled
      - disabled
      x-ms-enum:
        name: InfrastructureEncryption
        modelAsString: true
        values:
        - name: Enabled
          value: enabled
          description: Encryption is enabled
        - name: Disabled
          value: disabled
          description: Encryption is disabled
    ContextCacheAccountKind:
      type: string
      description: The kind of context cache account, determining storage topology.
      enum:
      - Regional
      - DataZone
      - Global
      x-ms-enum:
        name: ContextCacheAccountKind
        modelAsString: true
        values:
        - name: Regional
          value: Regional
          description: Single-region storage account
        - name: DataZone
          value: DataZone
          description: Multi-region within a data zone
        - name: Global
          value: Global
          description: All regions with global distribution
    Azure.ResourceManager.CommonTypes.CustomerManagedKeyEncryption:
      type: object
      description: Customer-managed key encryption properties for the resource.
      properties:
        keyEncryptionKeyIdentity:
          $ref: '#/components/schemas/Azure.ResourceManager.CommonTypes.KeyEncryptionKeyIdentity'
          description: All identity configuration for Customer-managed key settings defining which identity should be used to auth to Key Vault.
        keyEncryptionKeyUrl:
          type: string
          description: 'key encryption key Url, versioned or non-versioned. Ex: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 or https://contosovault.vault.azure.net/keys/contosokek.'
    ContextCache:
      type: object
      description: A Context Cache resource
      properties:
        properties:
          $ref: '#/components/schemas/ContextCacheProperties'
          description: The resource-specific properties for this resource.
        identity:
          $ref: '#/components/schemas/ManagedServiceIdentity'
          description: The managed service identities assigned to this resource.
      required:
      - properties
      allOf:
      - $ref: '#/components/schemas/TrackedResource'
    Azure.Core.uuid:
      type: string
      format: uuid
      description: Universally Unique Identifier
    ContextCacheCheckNameAvailabilityResult:
      type: object
      description: The result of the context cache name availability check.
      properties:
        nameAvailable:
          type: boolean
          description: A boolean value that indicates whether the context cache name is available to use. If true, the name is available. If false, the name has already been taken or is invalid and cannot be used.
          readOnly: true
        reason:
          $ref: '#/components/schemas/ContextCacheCheckNameAvailabilityFailureReason'
          description: The reason why the context cache name is not available. The Reason element is only returned if NameAvailable is false
          readOnly: true
        message:
          type: string
          description: The error message providing additional information about the context cache name availability check failure.
          readOnly: true
      required:
      - nameAvailable
    ContextCacheListResult:
      type: object
      description: The response of a ContextCache list operation.
      properties:
        value:
          type: array
          description: The ContextCache items on this page
          items:
            $ref: '#/components/schemas/ContextCache'
        nextLink:
          type: string
          format: uri
          description: The link to the next page of items
      required:
      - value
    Azure.ResourceManager.CommonTypes.KeyEncryptionKeyIdentityType:
      type: string
      description: The type of identity to use.
      enum:
      - systemAssignedIdentity
      - userAssignedIdentity
      - delegatedResourceIdentity
      x-ms-enum:
        name: KeyEncryptionKeyIdentityType
        modelAsString: true
        values:
        - name: SystemAssignedIdentity
          value: systemAssignedIdentity
          description: System assigned identity
        - name: UserAssignedIdentity
          value: userAssignedIdentity
          description: User assigned identity
        - name: DelegatedResourceIdentity
          value: delegatedResourceIdentity
          description: Delegated identity
    TypesErrorResponse:
      type: object
      title: Error response
      description: Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: The error object.
    ManagedServiceIdentity:
      type: object
      description: Managed service identity (system assigned and/or user assigned identities)
      properties:
        principalId:
          type: string
          format: uuid
          description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
          readOnly: true
        tenantId:
          type: string
          format: uuid
          description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
          readOnly: true
        type:
          $ref: '#/components/schemas/ManagedServiceIdentityType'
        userAssignedIdentities:
          $ref: '#/components/schemas/UserAssignedIdentities'
      required:
      - type
    Resource:
      type: object
      title: Resource
      description: Common fields that are returned in the response for all Azure Resource Manager resources
      properties:
        id:
          type: string
          format: arm-id
          description: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
          readOnly: true
        name:
          type: string
          description: The name of the resource
          readOnly: true
        type:
          type: string
          description: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
          readOnly: true
        systemData:
          $ref: '#/components/schemas/systemData'
          description: Azure Resource Manager metadata containing createdBy and modifiedBy information.
          readOnly: true
      x-ms-azure-resource: true
    ContextCachePropertiesUpdate:
      type: object
      description: Updatable properties of the Context Cache.
      properties:
        description:
          type: string
          description: Account description.
          maxLength: 250
        encryption:
          $ref: '#/components/schemas/Azure.ResourceManager.CommonTypes.Encryption'
          description: Encryption settings for the account.
    ContextCacheProperties:
      type: object
      description: Details of the Context Cache.
      properties:
        accountKind:
          $ref: '#/components/schemas/ContextCacheAccountKind'
          description: The kind of account determining storage topology.
          x-ms-mutability:
          - read
          - create
        description:
          type: string
          description: Account description.
          maxLength: 250
        provisioningState:
          $ref: '#/components/schemas/ContextCacheProvisioningState'
          description: The status of the last operation.
          readOnly: true
        encryption:
          $ref: '#/components/schemas/Azure.ResourceManager.CommonTypes.Encryption'
          description: Encryption settings for the account.
      required:
      - accountKind
    ContextCacheProvisioningState:
      type: string
      description: The status of the current operation.
      enum:
      - Succeeded
      - Failed
      - Canceled
      - Creating
      - Updating
      - Deleting
      - Accepted
      x-ms-enum:
        name: ContextCacheProvisioningState
        modelAsString: true
        values:
        - name: Succeeded
          value: Succeeded
          description: Resource has been created.
        - name: Failed
          value: Failed
          description: Resource creation failed.
        - name: Canceled
          value: Canceled
          description: Resource creation was canceled.
        - name: Creating
          value: Creating
          description: Initial provisioning in progress
        - name: Updating
          value: Updating
          description: Update in progress
        - name: Deleting
          value: Deleting
          description: Deletion in progress
        - name: Accepted
          value: Accepted
          description: Change accepted for processing
      readOnly: true
    Azure.ResourceManager.CommonTypes.KeyEncryptionKeyIdentity:
      type: object
      description: All identity configuration for Customer-managed key settings defining which identity should be used to auth to Key Vault.
      properties:
        identityType:
          $ref: '#/components/schemas/Azure.ResourceManager.CommonTypes.KeyEncryptionKeyIdentityType'
          description: The type of identity to use. Values can be systemAssignedIdentity, userAssignedIdentity, or delegatedResourceIdentity.
        userAssignedIdentityResourceId:
          type: string
          format: arm-id
          description: 'User assigned identity to use for accessing key encryption key Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutually exclusive with identityType systemAssignedIdentity.'
        federatedClientId:
          $ref: '#/components/schemas/Azure.Core.uuid'
          description: 'application client identity to use for accessing key encryption key Url in a different tenant. Ex: f83c6b1b-4d34-47e4-bb34-9d83df58b540'
        delegatedIdentityClientId:
          $ref: '#/components/schemas/Azure.Core.uuid'
          description: 'delegated identity to use for accessing key encryption key Url. Ex: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutually exclusive with identityType systemAssignedIdentity and userAssignedIdentity - internal use only.'
    Azure.ResourceManager.CommonTypes.Encryption:
      type: object
      description: (Optional) Discouraged to include in resource definition. Only needed where it is possible to disable platform (AKA infrastructure) encryption. Azure SQL TDE is an example of this. Values are enabled and disabled.
      properties:
        infrastructureEncryption:
          $ref: '#/components/schemas/Azure.ResourceManager.CommonTypes.InfrastructureEncryption'
          description: Values are enabled and disabled.
        customerManagedKeyEncryption:
          $ref: '#/components/schemas/Azure.ResourceManager.CommonTypes.CustomerManagedKeyEncryption'
          description: All Customer-managed key encryption properties for the resource.
    ContextCacheCheckNameAvailabilityParameters:
      type: object
      description: The parameters used to check the availability of the context cache resource name.
      properties:
        name:
          type: string
          description: The name of the context cache resource to check for availability.
          pattern: ^[a-z0-9][a-z0-9-]{1,22}[a-z0-9]$
        type:
          type: string
          description: The type of the context cache resource to check for availability.
          enum:
          - Microsoft.Storage/contextCaches
          x-ms-enum:
            modelAsString: false
      required:
      - name
      - type
    TrackedResource:
      type: object
      title: Tracked Resource
      description: The resource model definition for an Azure Resource Manager tracked top level resource which has 'tags' and a 'location'
      properties:
        tags:
          type: object
          description: Resource tags.
          additionalProperties:
            type: string
          x-ms-mutability:
          - read
          - create
          - update
        location:
          type: string
          description: The geo-location where the resource lives
          x-ms-mutability:
          - read
          - create
      required:
      - location
      allOf:
      - $ref: '#/components/schemas/Resource'
  parameters:
    ResourceGroupNameParameter:
      name: resourceGroupName
      in: path
      description: The name of the resource group. The name is case insensitive.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
        maxLength: 90
        minLength: 1
    SubscriptionIdParameter:
      name: subscriptionId
      in: path
      description: The ID of the target subscription. The value must be an UUID.
      required: true
      schema:
        type: string
        format: uuid
    ApiVersionParameter:
      name: api-version
      in: query
      description: The API version to use for this operation.
      required: true
      schema:
        type: string
        minLength: 1
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.