Class KmsVaultPaginators

Collection of helper methods that can be used to provide an enumerator interface to any list operations of KmsVault where multiple pages of data may be fetched. Two styles of enumerators are supported:

• Enumerating over the Response objects returned by the list operation. These are referred to as ResponseEnumerators, and the methods are suffixed with ResponseEnumerator. For example: listUsersResponseEnumerator.
• Enumerating over the resources/records being listed. These are referred to as RecordEnumerators, and the methods are suffixed with RecordEnumerator. For example: listUsersRecordEnumerator.

These enumerators abstract away the need to write code to manually handle pagination via looping and using the page tokens. They will automatically fetch more data from the service when required.

As an example, if we were using the ListUsers operation in IdentityService, then the iterator returned by calling a ResponseEnumerator method would iterate over the ListUsersResponse objects returned by each ListUsers call, whereas the enumerables returned by calling a RecordEnumerator method would iterate over the User records and we don't have to deal with ListUsersResponse objects at all. In either case, pagination will be automatically handled so we can iterate until there are no more responses or no more resources/records available.

Inheritance

object

KmsVaultPaginators

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Oci.KeymanagementService

Assembly: OCI.DotNetSDK.Keymanagement.dll

Syntax

public class KmsVaultPaginators

Constructors

KmsVaultPaginators(KmsVaultClient)

Declaration

public KmsVaultPaginators(KmsVaultClient client)

Parameters

Type	Name	Description
KmsVaultClient	client

Methods

ListVaultReplicasRecordEnumerator(ListVaultReplicasRequest, RetryConfiguration, CancellationToken)

Creates a new enumerable which will iterate over the VaultReplicaSummary objects contained in responses from the ListVaultReplicas operation. This enumerable will fetch more data from the server as needed.

Declaration

public IEnumerable<VaultReplicaSummary> ListVaultReplicasRecordEnumerator(ListVaultReplicasRequest request, RetryConfiguration retryConfiguration = null, CancellationToken cancellationToken = default)

Parameters

Type	Name	Description
ListVaultReplicasRequest	request	The request object containing the details to send
RetryConfiguration	retryConfiguration	The configuration for retrying, may be null
CancellationToken	cancellationToken	The cancellation token object

Returns

Type	Description
IEnumerable<VaultReplicaSummary>	The enumerator, which supports a simple iteration over a collection of a specified type

ListVaultReplicasResponseEnumerator(ListVaultReplicasRequest, RetryConfiguration, CancellationToken)

Creates a new enumerable which will iterate over the responses received from the ListVaultReplicas operation. This enumerable will fetch more data from the server as needed.

Declaration

public IEnumerable<ListVaultReplicasResponse> ListVaultReplicasResponseEnumerator(ListVaultReplicasRequest request, RetryConfiguration retryConfiguration = null, CancellationToken cancellationToken = default)

Parameters

Type	Name	Description
ListVaultReplicasRequest	request	The request object containing the details to send
RetryConfiguration	retryConfiguration	The configuration for retrying, may be null
CancellationToken	cancellationToken	The cancellation token object

Returns

Type	Description
IEnumerable<ListVaultReplicasResponse>	The enumerator, which supports a simple iteration over a collection of a specified type

ListVaultsRecordEnumerator(ListVaultsRequest, RetryConfiguration, CancellationToken)

Creates a new enumerable which will iterate over the VaultSummary objects contained in responses from the ListVaults operation. This enumerable will fetch more data from the server as needed.

Declaration

public IEnumerable<VaultSummary> ListVaultsRecordEnumerator(ListVaultsRequest request, RetryConfiguration retryConfiguration = null, CancellationToken cancellationToken = default)

Parameters

Type	Name	Description
ListVaultsRequest	request	The request object containing the details to send
RetryConfiguration	retryConfiguration	The configuration for retrying, may be null
CancellationToken	cancellationToken	The cancellation token object

Returns

Type	Description
IEnumerable<VaultSummary>	The enumerator, which supports a simple iteration over a collection of a specified type

ListVaultsResponseEnumerator(ListVaultsRequest, RetryConfiguration, CancellationToken)

Creates a new enumerable which will iterate over the responses received from the ListVaults operation. This enumerable will fetch more data from the server as needed.

Declaration

public IEnumerable<ListVaultsResponse> ListVaultsResponseEnumerator(ListVaultsRequest request, RetryConfiguration retryConfiguration = null, CancellationToken cancellationToken = default)

Parameters

Type	Name	Description
ListVaultsRequest	request	The request object containing the details to send
RetryConfiguration	retryConfiguration	The configuration for retrying, may be null
CancellationToken	cancellationToken	The cancellation token object

Returns

Type	Description
IEnumerable<ListVaultsResponse>	The enumerator, which supports a simple iteration over a collection of a specified type