# Container Registry API, gRPC: LifecyclePolicyService.ListDryRunResults

Retrieves the list of the dry run results.

## gRPC request

**rpc ListDryRunResults ([ListDryRunLifecyclePolicyResultsRequest](#yandex.cloud.containerregistry.v1.ListDryRunLifecyclePolicyResultsRequest)) returns ([ListDryRunLifecyclePolicyResultsResponse](#yandex.cloud.containerregistry.v1.ListDryRunLifecyclePolicyResultsResponse))**

## ListDryRunLifecyclePolicyResultsRequest {#yandex.cloud.containerregistry.v1.ListDryRunLifecyclePolicyResultsRequest}

```json
{
  "lifecycle_policy_id": "string",
  "page_size": "int64",
  "page_token": "string",
  "filter": "string",
  "order_by": "string"
}
```

#|
||Field | Description ||
|| lifecycle_policy_id | **string**

Required field. ID of the lifecycle policy.

The maximum string length in characters is 50. ||
|| page_size | **int64**

The maximum number of results per page to return. If the number of available
results is larger than `page_size`, the service returns
a [ListDryRunLifecyclePolicyResultsResponse.next_page_token](#yandex.cloud.containerregistry.v1.ListDryRunLifecyclePolicyResultsResponse) that can be used to get
the next page of results in subsequent list requests.

Acceptable values are 0 to 1000, inclusive. ||
|| page_token | **string**

Page token. To get the next page of results, set `page_token` to the
[ListDryRunLifecyclePolicyResultsResponse.next_page_token](#yandex.cloud.containerregistry.v1.ListDryRunLifecyclePolicyResultsResponse) returned by a previous list request.

The maximum string length in characters is 100. ||
|| filter | **string**

A filter expression that filters dry run results listed in the response.
The expression must specify:
1. The field name. Currently you can use filtering only on [LifecyclePolicy.name](get.md#yandex.cloud.containerregistry.v1.LifecyclePolicy) field.
2. An `=` operator.
3. The value in double quotes (`"`). Must be 3-63 characters long and match the regular expression `[a-z][-a-z0-9]{1,61}[a-z0-9]`.

The maximum string length in characters is 1000. ||
|| order_by | **string**

Sorting the list by [DryRunLifecyclePolicyResult.run_at](#yandex.cloud.containerregistry.v1.DryRunLifecyclePolicyResult) and [DryRunLifecyclePolicyResult.affected_images_count](#yandex.cloud.containerregistry.v1.DryRunLifecyclePolicyResult) fields.
The default sorting order is ascending.

The maximum string length in characters is 100. ||
|#

## ListDryRunLifecyclePolicyResultsResponse {#yandex.cloud.containerregistry.v1.ListDryRunLifecyclePolicyResultsResponse}

```json
{
  "dry_run_lifecycle_policy_results": [
    {
      "dry_run_lifecycle_policy_result_id": "string",
      "lifecycle_policy_id": "string",
      "run_at": "google.protobuf.Timestamp",
      "affected_images_count": "int64"
    }
  ],
  "next_page_token": "string"
}
```

#|
||Field | Description ||
|| dry_run_lifecycle_policy_results[] | **[DryRunLifecyclePolicyResult](#yandex.cloud.containerregistry.v1.DryRunLifecyclePolicyResult)**

List of results of dry runs of a lifecycle policy. ||
|| next_page_token | **string**

Token for getting the next page of the list. If the number of results is greater than
the specified [ListDryRunLifecyclePolicyResultsRequest.page_size](#yandex.cloud.containerregistry.v1.ListDryRunLifecyclePolicyResultsRequest) use `next_page_token` as the value
for the [ListDryRunLifecyclePolicyResultsRequest.page_token](#yandex.cloud.containerregistry.v1.ListDryRunLifecyclePolicyResultsRequest) parameter in the next list request.
Each subsequent page will have its own `next_page_token` to continue paging through the results. ||
|#

## DryRunLifecyclePolicyResult {#yandex.cloud.containerregistry.v1.DryRunLifecyclePolicyResult}

#|
||Field | Description ||
|| dry_run_lifecycle_policy_result_id | **string**

ID of the dry run result of the lifecycle policy. ||
|| lifecycle_policy_id | **string**

ID of the lifecycle policy. ||
|| run_at | **[google.protobuf.Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#timestamp)**

Time of the getting result. ||
|| affected_images_count | **int64**

Count of affected images. ||
|#