The C# .NET SDK currently only supports legacy versions of Nitric prior to v1. This version is maintained for compatibility with existing projects and not recommended for new projects. New projects should be started using a supported SDK (presented automatically using the `nitric new` command) orget in touch to request an update to the latest version.

.NET - Secret.Put()

Store a new secret value, creating a new version to store the value.

using Nitric.Sdk;
using Nitric.Sdk.Resource;

var keyRef = Nitric.Secret("apiKey").With(SecretPermission.Putting);

keyRef.Put("6c3199a3-094e-4797-bfc9-9ee2a7839286");

Nitric.Run();

Parameters

  • Name
    secret
    Required
    Required
    Type
    string
    Description

    The new secret value to store in the secrets manager.

Notes

A new secret version is always created when calling Put(), the versions will automatically be provided a unique id. This behavior is dependent on the underlying secrets manager.

Examples

Store a new secret value

using Nitric.Sdk;
using Nitric.Sdk.Resource;

var keyRef = Nitric.Secret("apiKey").With(SecretPermission.Putting);

keyRef.Put("6c3199a3-094e-4797-bfc9-9ee2a7839286");

Nitric.Run();

Get the id of a new secret version

Calling Put() returns a promise to a reference to the new secret version. Storing the ID of the new version can be useful if you need to retrieve that specific value again in future using version.access()

using Nitric.Sdk;
using Nitric.Sdk.Resource;

var keyRef = Nitric.Secret("apiKey").With(SecretPermission.Putting);

var newApiKeyVersionRef = keyRef.Put("6c3199a3-094e-4797-bfc9-9ee2a7839286");

var versionId = newApiKeyVersionRef.Id;

Nitric.Run();