/// <summary>
/// List all versions of the specified secret.
/// </summary>
/// <remarks>
/// The full secret identifier and attributes are provided in the response. No
/// values are returned for the secrets. This operations requires the
/// secrets/list permission.
/// </remarks>
/// <param name="name">The name of the secret.</param>
/// <param name="cancellationToken">A <see cref="CancellationToken"/> controlling the request lifetime.</param>
public virtual Pageable <SecretProperties> GetPropertiesOfSecretVersions(string name, CancellationToken cancellationToken = default)
{
Argument.AssertNotNullOrEmpty(name, nameof(name));
Uri firstPageUri = new Uri(VaultUri, $"{SecretsPath}{name}/versions?api-version={_pipeline.ApiVersion}");
return(PageResponseEnumerator.CreateEnumerable(nextLink => _pipeline.GetPage(firstPageUri, nextLink, () => new SecretProperties(), "Azure.Security.KeyVault.Secrets.SecretClient.GetPropertiesOfSecretVersions", cancellationToken)));
}
/// <summary>
/// Lists the properties of all enabled and disabled versions of the specified secret. You can use the returned <see cref="SecretProperties.Name"/> and <see cref="SecretProperties.Version"/> in subsequent calls to <see cref="GetSecret"/>.
/// </summary>
/// <remarks>
/// <para>
/// The full secret identifier and attributes are provided in the response. No
/// values are returned for the secrets. This operations requires the
/// secrets/list permission.
/// </para>
/// <para>
/// Managed secrets may also be listed. They contain the certificate and private key for certificates stored in Key Vault.
/// </para>
/// </remarks>
/// <param name="name">The name of the secret.</param>
/// <param name="cancellationToken">A <see cref="CancellationToken"/> controlling the request lifetime.</param>
/// <exception cref="ArgumentException"><paramref name="name"/> is an empty string.</exception>
/// <exception cref="ArgumentNullException"><paramref name="name"/> is null.</exception>
/// <exception cref="RequestFailedException">The server returned an error. See <see cref="Exception.Message"/> for details returned from the server.</exception>
public virtual Pageable <SecretProperties> GetPropertiesOfSecretVersions(string name, CancellationToken cancellationToken = default)
{
Argument.AssertNotNullOrEmpty(name, nameof(name));
Uri firstPageUri = _pipeline.CreateFirstPageUri($"{SecretsPath}{name}/versions");
return(PageResponseEnumerator.CreateEnumerable(nextLink => _pipeline.GetPage(firstPageUri, nextLink, () => new SecretProperties(), "SecretClient.GetPropertiesOfSecretVersions", cancellationToken)));
}
/// <summary>
/// List all versions of the specified secret.
/// </summary>
/// <remarks>
/// The full secret identifier and attributes are provided in the response. No
/// values are returned for the secrets. This operations requires the
/// secrets/list permission.
/// </remarks>
/// <param name="name">The name of the secret.</param>
/// <param name="cancellationToken">A <see cref="CancellationToken"/> controlling the request lifetime.</param>
public virtual IEnumerable <Response <SecretBase> > GetSecretVersions(string name, CancellationToken cancellationToken = default)
{
if (string.IsNullOrEmpty(name))
{
throw new ArgumentException($"{nameof(name)} must not be null or empty", nameof(name));
}
Uri firstPageUri = new Uri(_vaultUri, $"{SecretsPath}{name}/versions?api-version={_pipeline.ApiVersion}");
return(PageResponseEnumerator.CreateEnumerable(nextLink => _pipeline.GetPage(firstPageUri, nextLink, () => new SecretBase(), "Azure.Security.KeyVault.Secrets.SecretClient.GetSecretVersions", cancellationToken)));
}