---
title: "Creates or updates a secret resource."
method: PUT
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/secrets/{secretResourceName}"
tags: ["Secrets"]
---

# Creates or updates a secret resource.

`PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/secrets/{secretResourceName}`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/secrets/{secretResourceName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

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

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `secretResourceName` string, required

## Query parameters

- `api-version` '2018-09-01-preview', required

## Request body

- SecretResourceDescription: The resource model definition for Azure Resource Manager resource.
  - `id` string: Fully qualified identifier for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
  - `name` string: The name of the resource
  - `type` string: The type of the resource. Ex- Microsoft.Compute/virtualMachines or Microsoft.Storage/storageAccounts.

## Response `200`

OK

- SecretResourceDescription: The resource model definition for Azure Resource Manager resource.
  - `id` string: Fully qualified identifier for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
  - `name` string: The name of the resource
  - `type` string: The type of the resource. Ex- Microsoft.Compute/virtualMachines or Microsoft.Storage/storageAccounts.

## Other responses

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

## Changes

- **2026-07-13** (2018-07-01-preview) `4a181d9224af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/azure/apis/servicefabricmesh-microsoft-servicefabricmesh-servicefabricm/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.ServiceFabricMesh/secrets/:secretResourceName/put.md)

---

[API](https://skmtc.dev/azure/apis/servicefabricmesh-microsoft-servicefabricmesh-servicefabricm.md) - [All operations](https://skmtc.dev/azure/apis/servicefabricmesh-microsoft-servicefabricmesh-servicefabricm/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/servicefabricmesh-microsoft-servicefabricmesh-servicefabricm/revisions/4a181d9224af?raw)