---
title: "POST /RegisterResource"
method: POST
path: "/RegisterResource"
---

# POST /RegisterResource

`POST /RegisterResource`

Registers the resource as managed by the Data Catalog.

To add or update data, Lake Formation needs read/write access to the chosen Amazon S3 path. Choose a role that you know has permission to do this, or choose the AWSServiceRoleForLakeFormationDataAccess service-linked role. When you register the first Amazon S3 path, the service-linked role and a new inline policy are created on your behalf. Lake Formation adds the first path to the inline policy and attaches it to the service-linked role. When you register subsequent paths, Lake Formation adds the path to the existing policy.

The following request registers a new location and gives Lake Formation permission to use the service-linked role to access that location.

`ResourceArn = arn:aws:s3:::my-bucket UseServiceLinkedRole = true`

If `UseServiceLinkedRole` is not set to true, you must provide or set the `RoleArn`:

`arn:aws:iam::12345:role/my-data-access-role`

## Request body

- object
  - `ResourceArn` string, required — The Amazon Resource Name (ARN) of the resource that you want to register.
  - `UseServiceLinkedRole` boolean — <p>Designates an Identity and Access Management (IAM) service-linked role by registering this role with the Data Catalog. A service-linked role is a unique type of IAM role that is linked directly to Lake Formation.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/lake-formation/latest/dg/service-linked-roles.html">Using Service-Linked Roles for Lake Formation</a>.</p>
  - `RoleArn` string — The identifier for the role that registers the resource.
  - `WithFederation` boolean — Whether or not the resource is a federated resource.

## Response `200`

Success

- RegisterResourceResponse

## Other responses

- `480` — InvalidInputException
- `481` — InternalServiceException
- `482` — OperationTimeoutException
- `483` — AlreadyExistsException
- `484` — EntityNotFoundException
- `485` — ResourceNumberLimitExceededException
- `486` — AccessDeniedException

---

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