---
title: "Creates or updates a Volume resource."
method: PUT
path: "/Resources/Volumes/{volumeResourceName}"
tags: ["MeshVolumes"]
---

# Creates or updates a Volume resource.

`PUT /Resources/Volumes/{volumeResourceName}`

Creates a Volume resource with the specified name, description and properties. If Volume resource with the same name exists, then it is updated with the specified description and properties.

## Path parameters

- `volumeResourceName` string, required

## Query parameters

- `api-version` '6.4-preview', required

## Request body

- VolumeResourceDescription — This type describes a volume resource.
  - `name` string, required — Name of the Volume resource.
  - `properties` VolumeProperties, required — Describes properties of a volume resource.
    - `description` string — User readable description of the volume.
    - `status` 'Unknown' | 'Ready' | 'Upgrading' | 'Creating' | 'Deleting' | 'Failed' — Status of the resource.
    - `statusDetails` string — Gives additional information about the current status of the volume.
    - `provider` 'SFAzureFile', required — Describes the provider of the volume resource.
    - `azureFileParameters` VolumeProviderParametersAzureFile — This type describes a volume provided by an Azure Files file share.
      - `accountName` string, required — Name of the Azure storage account for the File Share.
      - `accountKey` string — Access key of the Azure storage account for the File Share.
      - `shareName` string, required — Name of the Azure Files file share that provides storage for the volume.

## Response `200`

OK

- VolumeResourceDescription — This type describes a volume resource.
  - `name` string, required — Name of the Volume resource.
  - `properties` VolumeProperties, required — Describes properties of a volume resource.
    - `description` string — User readable description of the volume.
    - `status` 'Unknown' | 'Ready' | 'Upgrading' | 'Creating' | 'Deleting' | 'Failed' — Status of the resource.
    - `statusDetails` string — Gives additional information about the current status of the volume.
    - `provider` 'SFAzureFile', required — Describes the provider of the volume resource.
    - `azureFileParameters` VolumeProviderParametersAzureFile — This type describes a volume provided by an Azure Files file share.
      - `accountName` string, required — Name of the Azure storage account for the File Share.
      - `accountKey` string — Access key of the Azure storage account for the File Share.
      - `shareName` string, required — Name of the Azure Files file share that provides storage for the volume.

## Other responses

- `201` — Created
- `202` — Accepted
- `default` — Error

---

[API](https://skmtc.net/azure/apis/service-fabric-client-apis.md) · [All operations](https://skmtc.net/azure/apis/service-fabric-client-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/service-fabric-client-apis/versions/6df9f2f4d542/schema)