

# 등록된 위치에 대한 세부 정보 보기
<a name="access-grants-location-view"></a>

Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, AWS SDK를 사용하여 S3 Access Grants 인스턴스에 등록된 위치의 세부 정보를 가져올 수 있습니다.

## S3 콘솔 사용
<a name="access-grants-location-edit-console"></a>

**S3 Access Grants 인스턴스에 등록된 위치를 보는 방법**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **Access Grants**를 선택합니다.

1. **S3 Access Grants** 페이지에서 사용하려는 S3 Access Grants 인스턴스가 포함된 리전을 선택합니다.

1. 인스턴스의 **세부 정보 보기**를 선택합니다.

1. 인스턴스의 세부 정보 페이지에서 **위치** 탭을 선택합니다.

1. 확인하고자 하는 등록 위치를 찾습니다. 등록된 위치 목록을 필터링하려면 검색 상자를 사용합니다.

## AWS CLI 사용
<a name="access-grants-location-edit-cli"></a>

AWS CLI를 설치하려면 *AWS Command Line Interface 사용 설명서*의 [AWS CLI 설치](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)를 참조하세요.

다음 예시 명령을 사용하려면 `{{user input placeholders}}`를 실제 정보로 대체하세요.

**Example - 등록된 위치에 대한 세부 정보 가져오기**  

```
aws s3control get-access-grants-location \
--account-id {{111122223333}} \
--access-grants-location-id {{default}}
```
응답:  

```
{
    "CreatedAt": "{{2023-05-31T18:23:48.107000+00:00}}",
    "AccessGrantsLocationId": "{{default}}",
    "AccessGrantsLocationArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/{{default}}",
    "IAMRoleArn": "arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}"
}
```

**Example - S3 Access Grants 인스턴스에 등록된 모든 위치 나열**  
결과를 S3 접두사 또는 버킷으로 제한하려면 선택적으로 `--location-scope s3://{{bucket-and-or-prefix}}` 파라미터를 사용할 수 있습니다.  

```
aws s3control list-access-grants-locations \
--account-id {{111122223333}} \
--region {{us-east-2}}
```
응답:  

```
{"AccessGrantsLocationsList": [
  {
    "CreatedAt": "{{2023-05-31T18:23:48.107000+00:00}}",
    "AccessGrantsLocationId": "default",
    "AccessGrantsLocationArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/default",
    "LocationScope": "s3://" 
    "IAMRoleArn": "arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}"
     },
  {
    "CreatedAt": "{{2023-05-31T18:23:48.107000+00:00}}",
    "AccessGrantsLocationId": "{{635f1139-1af2-4e43-8131-a4de006eb456}}",
    "AccessGrantsLocationArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/{{635f1139-1af2-4e43-8131-a4de006eb888}}",
    "LocationScope": "s3://{{amzn-s3-demo-bucket/prefixA*}}",
    "IAMRoleArn": "arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}"
     }
   ]
  }
```

## REST API 사용
<a name="access-grants-location-edit-rest-api"></a>

등록된 위치의 세부 정보를 가져오거나 S3 Access Grants 인스턴스에 등록된 모든 위치를 나열하기 위한 Amazon S3 REST API 지원에 대한 자세한 내용은 **Amazon Simple Storage Service API 참조의 다음 섹션을 참조하세요.
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrantsLocation.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrantsLocation.html) 
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrantsLocations.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrantsLocations.html) 

## AWS SDK 사용
<a name="access-grants-location-edit-using-sdk"></a>

이 섹션에서는 AWS SDK를 사용하여 S3 Access Grants 인스턴스에 등록된 위치에 대한 세부 정보를 가져오거나 S3 Access Grants 인스턴스에 등록된 위치를 모두 나열하는 방법의 예시를 보여줍니다.

다음 예제를 사용하려면 `{{user input placeholders}}`를 사용자의 정보로 대체합니다.

------
#### [ Java ]

**Example - 등록된 위치에 대한 세부 정보 가져오기**  

```
public void getAccessGrantsLocation() {
GetAccessGrantsLocationRequest getAccessGrantsLocationRequest = GetAccessGrantsLocationRequest.builder()
.accountId("{{111122223333}}")
.accessGrantsLocationId("default")
.build();
GetAccessGrantsLocationResponse getAccessGrantsLocationResponse = s3Control.getAccessGrantsLocation(getAccessGrantsLocationRequest);
LOGGER.info("GetAccessGrantsLocationResponse: " + getAccessGrantsLocationResponse);
}
```
응답:  

```
GetAccessGrantsLocationResponse(
CreatedAt={{2023-06-07T04:35:10.027Z}},
AccessGrantsLocationId=default,
AccessGrantsLocationArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/default,
LocationScope= s3://,
IAMRoleArn=arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}
)
```

**Example - S3 Access Grants 인스턴스에 등록된 모든 위치 나열**  
결과를 S3 접두사 또는 버킷으로 제한하려면 선택적으로 `LocationScope` 파라미터에 `s3://{{bucket-and-or-prefix}}`와 같은 S3 URI를 전달할 수 있습니다.  

```
public void listAccessGrantsLocations() {

ListAccessGrantsLocationsRequest listRequest =   ListAccessGrantsLocationsRequest.builder()
.accountId("{{111122223333}}")
.build();

ListAccessGrantsLocationsResponse listResponse = s3Control.listAccessGrantsLocations(listRequest);
LOGGER.info("ListAccessGrantsLocationsResponse: " + listResponse);
}
```
응답:  

```
ListAccessGrantsLocationsResponse(
AccessGrantsLocationsList=[
ListAccessGrantsLocationsEntry(
CreatedAt={{2023-06-07T04:35:11.027Z}},
AccessGrantsLocationId=default,
AccessGrantsLocationArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/default,
LocationScope=s3://,
IAMRoleArn=arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}
),
ListAccessGrantsLocationsEntry(
CreatedAt={{2023-06-07T04:35:10.027Z}},
AccessGrantsLocationId={{635f1139-1af2-4e43-8131-a4de006eb456}},
AccessGrantsLocationArn=arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default/location/{{635f1139-1af2-4e43-8131-a4de006eb888}},
LocationScope=s3://{{amzn-s3-demo-bucket/prefixA*}},
IAMRoleArn=arn:aws:iam::{{111122223333}}:role/{{accessGrantsTestRole}}
)
]
)
```

------