기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 지오펜스 컬렉션 리소스 관리
Amazon Location 콘솔 AWS CLI, 또는 Amazon Location APIs를 사용하여 지오펜스 컬렉션을 관리합니다.
## 지오펜스 컬렉션 리소스를 나열합니다.
Amazon Location 콘솔 AWS CLI, 또는 Amazon Location APIs.
------
#### [ Console ]
**Amazon Location 콘솔을 사용하여 지오펜스 컬렉션 목록을 보려면**
1. [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)에서 Amazon Location 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **지오펜스 컬렉션**을 선택합니다.
1. **내 지오펜스 컬렉션**에서 지오펜스 컬렉션 목록을 볼 수 있습니다.
------
#### [ API ]
Amazon Location 지오펜스 API에서 `[ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html)` 작업을 사용합니다.
다음 예제는 AWS 계정의 지오펜스 컬렉션 목록을 가져오기 위한 API 요청입니다.
```
POST /geofencing/v0/list-collections
```
다음은 `ListGeofenceCollections`에 대한 응답의 예입니다.
```
{
"Entries": [
{
"CollectionName": "{{ExampleCollection}}",
"CreateTime": 2020-09-30T22:59:34.142Z,
"Description": "string",
"UpdateTime": 2020-09-30T23:59:34.142Z
},
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
`[list-geofence-collections](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofence-collections.html)` 명령을 사용합니다.
다음 예제는 AWS 계정의 지오펜스 컬렉션 목록을 AWS CLI 가져오는 입니다.
```
aws location list-geofence-collections
```
------
## 지오펜스 컬렉션 세부 정보 가져오기
Amazon Location 콘솔 AWS CLI, 또는 Amazon Location API를 사용하여 AWS 계정의 모든 지오펜스 컬렉션 리소스에 대한 세부 정보를 가져올 수 있습니다. APIs
------
#### [ Console ]
**Amazon Location 콘솔을 사용하여 지오펜스 컬렉션의 세부 정보를 보려면**
1. [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)에서 Amazon Location 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **지오펜스 컬렉션**을 선택합니다.
1. **내 지오펜스 컬렉션**에서 대상 지오펜스 컬렉션의 이름 링크를 선택합니다.
------
#### [ API ]
Amazon Location 지오펜스 API에서 `[DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html)` 작업을 사용합니다.
다음 예시는 {{ExampleCollection}}의 지오펜스 컬렉션 세부 정보를 가져오기 위한 API 요청입니다.
```
GET /geofencing/v0/collections/{{ExampleCollection}}
```
다음은 `DescribeGeofenceCollection`에 대한 응답의 예입니다.
```
{
"CollectionArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GeofenceCollection",
"CollectionName": "{{ExampleCollection}}",
"CreateTime": 2020-09-30T22:59:34.142Z,
"Description": "string",
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"Tags": {
"Tag1" : "Value1"
},
"UpdateTime": 2020-09-30T23:59:34.142Z
}
```
------
#### [ CLI ]
`[describe-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/describe-geofence-collection.html)` 명령을 사용합니다.
다음 예제는 {{ExampleCollection}}에 대한 AWS CLI 지오펜스 컬렉션 세부 정보를 가져오는 입니다.
```
aws location describe-geofence-collection \
--collection-name "{{ExampleCollection}}"
```
------
## 지오펜스 컬렉션 삭제
Amazon Location 콘솔 AWS CLI, 또는 Amazon Location API를 사용하여 AWS 계정에서 지오펜스 컬렉션을 삭제할 수 있습니다. APIs
------
#### [ Console ]
**Amazon Location 콘솔을 사용하여 지오펜스 컬렉션을 삭제하려면**
**주의**
이 작업은 리소스를 영구적으로 삭제합니다.
1. [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)에서 Amazon Location 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **지오펜스 컬렉션**을 선택합니다.
1. **내 지오펜스 컬렉션**에서 대상 지오펜스 컬렉션을 선택합니다.
1. **지오펜스 컬렉션 삭제**를 선택합니다.
------
#### [ API ]
Amazon Location API에서 `[DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html)` 작업을 사용합니다.
다음 예시는 지오펜스 컬렉션 {{ExampleCollection}}을 삭제하기 위한 API 요청입니다.
```
DELETE /geofencing/v0/collections/{{ExampleCollection}}
```
다음은 `DeleteGeofenceCollection`에 대한 응답의 예입니다.
```
HTTP/1.1 200
```
------
#### [ CLI ]
`[delete-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/delete-geofence-collection.html)` 명령을 사용합니다.
다음 예제는 지오펜스 컬렉션 {{ExampleCollection}}을 삭제하는 AWS CLI 명령입니다.
```
aws location delete-geofence-collection \
--collection-name "{{ExampleCollection}}"
```
------
## 저장된 지오펜스 나열
Amazon Location 콘솔 AWS CLI, 또는 Amazon Location APIs.
------
#### [ Console ]
**Amazon Location 콘솔을 사용하여 지오펜스 목록을 보려면**
1. [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)에서 Amazon Location 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **지오펜스 컬렉션**을 선택합니다.
1. **내 지오펜스 컬렉션**에서 대상 지오펜스 컬렉션의 이름 링크를 선택합니다.
1. **지오펜스**의 지오펜스 컬렉션에서 지오펜스 확인하기
------
#### [ API ]
Amazon Location 지오펜스 API에서 `[ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html)` 작업을 사용합니다.
다음 예시는 지오펜스 컬렉션 {{ExampleCollection}}에 저장된 지오펜스 목록을 가져오기 위한 API 요청입니다.
```
POST /geofencing/v0/collections/{{ExampleCollection}}/list-geofences
```
다음은 `ListGeofences`에 대한 응답의 예입니다.
```
{
"Entries": [
{
"CreateTime": 2020-09-30T22:59:34.142Z,
"GeofenceId": "geofence-1",
"Geometry": {
"Polygon": [
[-5.716667, -15.933333,
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
},
"Status": "ACTIVE",
"UpdateTime": 2020-09-30T23:59:34.142Z
}
],
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
`[list-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofences.html)` 명령을 사용합니다.
다음 예제는 AWS CLI 지오펜스 컬렉션 {{ExampleCollection}}에 저장된 지오펜스 목록을 가져오는 입니다.
```
aws location list-geofences \
--collection-name "{{ExampleCollection}}"
```
------
## 지오펜스 세부 정보 가져오기
Amazon Location 콘솔 AWS CLI또는 Amazon Location APIs.
------
#### [ Console ]
**Amazon Location 콘솔을 사용하여 지오펜스의 상태를 보려면**
1. [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)에서 Amazon Location 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **지오펜스 컬렉션**을 선택합니다.
1. **내 지오펜스 컬렉션**에서 대상 지오펜스 컬렉션의 이름 링크를 선택합니다.
1. **지오펜스**에서 지오펜스의 상태를 볼 수 있습니다.
------
#### [ API ]
Amazon Location 지오펜스 API에서 `[GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html)` 작업을 사용합니다.
다음 예시는 지오펜스 컬렉션 {{ExampleCollection}}에서 지오펜스 세부 정보를 가져오기 위한 API 요청입니다.
```
GET /geofencing/v0/collections/{{ExampleCollection}}/geofences/{{ExampleGeofence1}}
```
다음은 `GetGeofence`에 대한 응답의 예입니다.
```
{
"CreateTime": 2020-09-30T22:59:34.142Z,
"GeofenceId": "{{ExampleGeofence1}}",
"Geometry": {
"Polygon": [
[-1,-1],
[1,-1],
[0,1],
[-1,-1]
]
},
"Status": "ACTIVE",
"UpdateTime": 2020-09-30T23:59:34.142Z
}
```
------
#### [ CLI ]
`[get-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/get-geofence.html)` 명령을 사용합니다.
다음 예제는 {{ExampleCollection}}에 대한 AWS CLI 지오펜스 컬렉션 세부 정보를 가져오는 입니다.
```
aws location get-geofence \
--collection-name "{{ExampleCollection}}" \
--geofence-id "{{ExampleGeofence1}}"
```
------
## 지오펜스 삭제
Amazon Location 콘솔, AWS CLI또는 Amazon Location API를 사용하여 지오펜스 컬렉션에서 지오펜스를 삭제할 수 있습니다.
------
#### [ Console ]
**Amazon Location 콘솔을 사용하여 지오펜스를 삭제하려면**
**주의**
이 작업은 리소스를 영구적으로 삭제합니다.
1. [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)에서 Amazon Location 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **지오펜스 컬렉션**을 선택합니다.
1. **내 지오펜스 컬렉션**에서 대상 지오펜스 컬렉션의 이름 링크를 선택합니다.
1. **지오펜스**에서 대상 지오펜스를 선택합니다.
1. **지오펜스 삭제**를 선택합니다.
------
#### [ API ]
Amazon Location 지오펜스 API에서 `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)` 작업을 사용합니다.
다음 예시는 지오펜스 컬렉션 {{ExampleCollection}}에서 지오펜스를 삭제하기 위한 API 요청입니다.
```
POST /geofencing/v0/collections/{{ExampleCollection}}/delete-geofences
Content-type: application/json
{
"GeofenceIds": [ "{{ExampleGeofence11}}" ]
}
```
다음은 `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)`에 대한 성공적인 응답의 예입니다.
```
HTTP/1.1 200
```
------
#### [ CLI ]
`[batch-delete-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/batch-delete-geofence.html)` 명령을 사용합니다.
다음 예제는 지오펜스 컬렉션 {{ExampleCollection}}에서 지오펜스를 삭제하는 AWS CLI 명령입니다.
```
aws location batch-delete-geofence \
--collection-name "{{ExampleCollection}}" \
--geofence-ids "{{ExampleGeofence11}}"
```
------