/// <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))); }