---
title: "GET /access-preview/{accessPreviewId}#analyzerArn"
method: GET
path: "/access-preview/{accessPreviewId}#analyzerArn"
---

# GET /access-preview/{accessPreviewId}#analyzerArn

`GET /access-preview/{accessPreviewId}#analyzerArn`

Retrieves information about an access preview for the specified analyzer.

## Path parameters

- `accessPreviewId` string, required

## Query parameters

- `analyzerArn` string, required

## Response `200`

Success

- GetAccessPreviewResponse
  - `accessPreview` object, required — An object that contains information about the access preview.
    - `id` string, required — The unique ID for the access preview.
    - `analyzerArn` string, required — The ARN of the analyzer used to generate the access preview.
    - `configurations` object, required — A map of resource ARNs for the proposed resource configuration.
    - `createdAt` string, date-time, required — The time at which the access preview was created.
    - `status` 'COMPLETED' | 'CREATING' | 'FAILED', required — <p>The status of the access preview.</p> <ul> <li> <p> <code>Creating</code> - The access preview creation is in progress.</p> </li> <li> <p> <code>Completed</code> - The access preview is complete. You can preview findings for external access to the resource.</p> </li> <li> <p> <code>Failed</code> - The access preview creation has failed.</p> </li> </ul>
    - `statusReason` object — <p>Provides more details about the current status of the access preview.</p> <p>For example, if the creation of the access preview fails, a <code>Failed</code> status is returned. This failure can be due to an internal issue with the analysis or due to an invalid resource configuration.</p>
      - `code` 'INTERNAL_ERROR' | 'INVALID_CONFIGURATION', required — The reason code for the current status of the access preview.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — ThrottlingException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/accessanalyzer.md) · [All operations](https://skmtc.net/aws/apis/accessanalyzer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/accessanalyzer/versions/d729b5bbb9cd/schema)
