# AWS CLI를 사용한 AWS IoT SiteWise 예시
다음 코드 예시에서는 AWS IoT SiteWise에서 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `associate-assets`
다음 코드 예시에서는 `associate-assets`의 사용 방법을 보여줍니다.
**AWS CLI**
**하위 자산을 상위 자산에 연결하는 방법**
다음 `associate-assets` 예시에서는 풍력 터빈 자산을 풍력 발전 단지 자산에 연결합니다. 풍력 터빈 자산 모델은 풍력 발전 단지 자산 모델의 계층 구조로 존재합니다.
```
aws iotsitewise associate-assets \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \
--hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE \
--child-asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Associating assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/add-associated-assets.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [AssociateAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/associate-assets.html) 섹션을 참조하세요.
### `batch-associate-project-assets`
다음 코드 예시에서는 `batch-associate-project-assets`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산을 프로젝트에 연결하는 방법**
다음 `batch-associate-project-assets` 예시에서는 풍력 발전 단지 자산을 프로젝트에 연결합니다.
```
aws iotsitewise batch-associate-project-assets \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--asset-ids a1b2c3d4-5678-90ab-cdef-44444EXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Adding assets to projects](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [BatchAssociateProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-associate-project-assets.html) 섹션을 참조하세요.
### `batch-disassociate-project-assets`
다음 코드 예시에서는 `batch-disassociate-project-assets`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트에서 자산을 연결 해제하는 방법**
다음 `batch-disassociate-project-assets` 예시에서는 프로젝트에서 풍력 발전 단지 자산을 연결 해제합니다.
```
aws iotsitewise batch-disassociate-project-assets \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--asset-ids a1b2c3d4-5678-90ab-cdef-44444EXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Adding assets to projects](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [BatchDisassociateProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-disassociate-project-assets.html) 섹션을 참조하세요.
### `batch-put-asset-property-value`
다음 코드 예시에서는 `batch-put-asset-property-value`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 속성으로 데이터 보내기**
다음 `batch-put-asset-property-value` 예시에서는 속성 별칭으로 식별된 자산 속성으로 전력 및 온도 데이터를 전송합니다.
```
aws iotsitewise batch-put-asset-property-value \
--cli-input-json file://batch-put-asset-property-value.json
```
`batch-put-asset-property-value.json`의 콘텐츠:
```
{
"entries": [
{
"entryId": "1575691200-company-windfarm-3-turbine-7-power",
"propertyAlias": "company-windfarm-3-turbine-7-power",
"propertyValues": [
{
"value": {
"doubleValue": 4.92
},
"timestamp": {
"timeInSeconds": 1575691200
},
"quality": "GOOD"
}
]
},
{
"entryId": "1575691200-company-windfarm-3-turbine-7-temperature",
"propertyAlias": "company-windfarm-3-turbine-7-temperature",
"propertyValues": [
{
"value": {
"integerValue": 38
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
출력:
```
{
"errorEntries": []
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Ingesting data using the AWS IoT SiteWise API](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ingest-api.html) 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [BatchPutAssetPropertyValue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/batch-put-asset-property-value.html) 섹션을 참조하세요.
### `create-access-policy`
다음 코드 예시에서는 `create-access-policy`의 사용 방법을 보여줍니다.
**AWS CLI**
**예시 1: 포털에 대한 사용자 관리 액세스 권한 부여**
다음 `create-access-policy` 예시에서는 풍력 발전 단지 회사의 웹 포털에 대한 사용자 관리 액세스 권한을 부여하는 액세스 정책을 생성합니다.
```
aws iotsitewise create-access-policy \
--cli-input-json file://create-portal-administrator-access-policy.json
```
`create-portal-administrator-access-policy.json`의 콘텐츠:
```
{
"accessPolicyIdentity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"accessPolicyPermission": "ADMINISTRATOR",
"accessPolicyResource": {
"portal": {
"id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE"
}
}
}
```
출력:
```
{
"accessPolicyId": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE",
"accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE"
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Adding or removing portal administrators](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins)를 참조하세요.
**예시 2: 사용자에게 프로젝트에 대한 읽기 전용 액세스 권한 부여**
다음 `create-access-policy` 예시에서는 풍력 발전소 프로젝트에 대한 읽기 전용 액세스 권한을 부여하는 액세스 정책을 생성합니다.
```
aws iotsitewise create-access-policy \
--cli-input-json file://create-project-viewer-access-policy.json
```
`create-project-viewer-access-policy.json`의 콘텐츠:
```
{
"accessPolicyIdentity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"accessPolicyPermission": "VIEWER",
"accessPolicyResource": {
"project": {
"id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE"
}
}
}
```
출력:
```
{
"accessPolicyId": "a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE",
"accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE"
}
```
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Assigning project viewers](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/assign-project-viewers.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-access-policy.html) 섹션을 참조하세요.
### `create-asset-model`
다음 코드 예시에서는 `create-asset-model`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 모델 생성**
다음 `create-asset-model` 예시에서는 다음 속성을 가진 풍력 터빈을 정의하는 자산 모델을 생성합니다.
일련 번호 - 풍력 터빈의 일련 번호발전 전력 - 풍력 터빈의 발전 전력 데이터 스트림온도 C - 풍력 터빈의 온도 데이터 스트림(섭씨 단위)온도 F - 섭씨에서 화씨로 매핑된 온도 데이터 포인트
```
aws iotsitewise create-asset-model \
--cli-input-json file://create-wind-turbine-model.json
```
`create-wind-turbine-model.json`의 콘텐츠:
```
{
"assetModelName": "Wind Turbine Model",
"assetModelDescription": "Represents a wind turbine",
"assetModelProperties": [
{
"name": "Serial Number",
"dataType": "STRING",
"type": {
"attribute": {}
}
},
{
"name": "Generated Power",
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"measurement": {}
}
},
{
"name": "Temperature C",
"dataType": "DOUBLE",
"unit": "Celsius",
"type": {
"measurement": {}
}
},
{
"name": "Temperature F",
"dataType": "DOUBLE",
"unit": "Fahrenheit",
"type": {
"transform": {
"expression": "temp_c * 9 / 5 + 32",
"variables": [
{
"name": "temp_c",
"value": {
"propertyId": "Temperature C"
}
}
]
}
}
},
{
"name": "Total Generated Power",
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"metric": {
"expression": "sum(power)",
"variables": [
{
"name": "power",
"value": {
"propertyId": "Generated Power"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
}
}
]
}
```
출력:
```
{
"assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"assetModelStatus": {
"state": "CREATING"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Defining asset models](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/define-models.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-asset-model.html) 섹션을 참조하세요.
### `create-asset`
다음 코드 예시에서는 `create-asset`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 생성**
다음 `create-asset` 예시에서는 풍력 터빈 자산 모델에서 풍력 터빈 자산을 생성합니다.
```
aws iotsitewise create-asset \
--asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
--asset-name "Wind Turbine 1"
```
출력:
```
{
"assetId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"assetArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"assetStatus": {
"state": "CREATING"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Creating assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-assets.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-asset.html) 섹션을 참조하세요.
### `create-dashboard`
다음 코드 예시에서는 `create-dashboard`의 사용 방법을 보여줍니다.
**AWS CLI**
**대시보드 생성**
다음 `create-dashboard` 예시에서는 풍력 발전 단지에 대해 생성된 총 전력을 표시하는 선 차트가 있는 대시보드를 생성합니다.
```
aws iotsitewise create-dashboard \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--dashboard-name "Wind Farm" \
--dashboard-definition file://create-wind-farm-dashboard.json
```
`create-wind-farm-dashboard.json`의 콘텐츠:
```
{
"widgets": [
{
"type": "monitor-line-chart",
"title": "Generated Power",
"x": 0,
"y": 0,
"height": 3,
"width": 3,
"metrics": [
{
"label": "Power",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE"
}
]
}
]
}
```
출력:
```
{
"dashboardId": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE",
"dashboardArn": "arn:aws:iotsitewise:us-west-2:123456789012:dashboard/a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE"
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Creating dashboards (CLI)](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-dashboards-using-aws-cli.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-dashboard.html) 섹션을 참조하세요.
### `create-gateway`
다음 코드 예시에서는 `create-gateway`의 사용 방법을 보여줍니다.
**AWS CLI**
**게이트웨이 생성**
다음 `create-gateway` 예시에서는 AWS IoT Greengrass에서 실행되는 게이트웨이를 생성합니다.
```
aws iotsitewise create-gateway \
--gateway-name ExampleCorpGateway \
--gateway-platform greengrass={groupArn=arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-1b1b1EXAMPLE}
```
출력:
```
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayArn": "arn:aws:iotsitewise:us-west-2:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Configuring a gateway](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-gateway.html) 섹션을 참조하세요.
### `create-portal`
다음 코드 예시에서는 `create-portal`의 사용 방법을 보여줍니다.
**AWS CLI**
**포털 생성**
다음 `create-portal` 예시에서는 풍력 발전 단지 회사의 웹 포털을 생성합니다. AWS Single Sign-On을 활성화한 동일한 리전에서만 포털을 생성할 수 있습니다.
```
aws iotsitewise create-portal \
--portal-name WindFarmPortal \
--portal-description "A portal that contains wind farm projects for Example Corp." \
--portal-contact-email support@example.com \
--role-arn arn:aws:iam::123456789012:role/service-role/MySiteWiseMonitorServiceRole
```
출력:
```
{
"portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"portalArn": "arn:aws:iotsitewise:us-west-2:123456789012:portal/a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"portalStartUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws",
"portalStatus": {
"state": "CREATING"
},
"ssoApplicationId": "ins-a1b2c3d4-EXAMPLE"
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Getting started with AWS IoT SiteWise Monitor](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-getting-started.html) 및 *AWS IoT SiteWise 사용 설명서*의 [Enabling AWS SSO](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-getting-started.html#monitor-enable-sso)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreatePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-portal.html) 섹션을 참조하세요.
### `create-project`
다음 코드 예시에서는 `create-project`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트 생성**
다음 `create-project` 예시에서는 프로젝트를 생성합니다.
```
aws iotsitewise create-project \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE \
--project-name "Wind Farm 1" \
--project-description "Contains asset visualizations for Wind Farm #1 for Example Corp."
```
출력:
```
{
"projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"projectArn": "arn:aws:iotsitewise:us-west-2:123456789012:project/a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE"
}
```
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Creating projects](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/create-projects.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/create-project.html)를 참조하세요.
### `delete-access-policy`
다음 코드 예시에서는 `delete-access-policy`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트 또는 포털에 대한 사용자의 액세스를 취소하는 방법**
다음 `delete-access-policy` 예시에서는 포털에 대한 사용자 관리 액세스 권한을 부여하는 액세스 정책을 삭제합니다.
```
aws iotsitewise delete-access-policy \
--access-policy-id a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Adding or removing portal administrators](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-access-policy.html) 섹션을 참조하세요.
### `delete-asset-model`
다음 코드 예시에서는 `delete-asset-model`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 모델 삭제**
다음 `delete-asset-model` 예시에서는 풍력 터빈 자산 모델을 삭제합니다.
```
aws iotsitewise delete-asset-model \
--asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
```
출력:
```
{
"assetModelStatus": {
"state": "DELETING"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Deleting asset models](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-assets-and-models.html#delete-asset-models)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-asset-model.html) 섹션을 참조하세요.
### `delete-asset`
다음 코드 예시에서는 `delete-asset`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 삭제**
다음 `delete-asset` 예시에서는 풍력 터빈 자산을 삭제합니다.
```
aws iotsitewise delete-asset \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
출력:
```
{
"assetStatus": {
"state": "DELETING"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Deleting assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-assets-and-models.html#delete-assets)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-asset.html) 섹션을 참조하세요.
### `delete-dashboard`
다음 코드 예시에서는 `delete-dashboard`의 사용 방법을 보여줍니다.
**AWS CLI**
**대시보드 삭제**
다음 `delete-dashboard` 예시에서는 풍력 터빈 대시보드를 삭제합니다.
```
aws iotsitewise delete-dashboard \
--dashboard-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Deleting dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-dashboards.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-dashboard.html) 섹션을 참조하세요.
### `delete-gateway`
다음 코드 예시에서는 `delete-gateway`의 사용 방법을 보여줍니다.
**AWS CLI**
**게이트웨이 삭제**
다음 `delete-gateway` 예시에서는 게이트웨이를 삭제합니다.
```
aws iotsitewise delete-gateway \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Ingesting data using a gateway](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-gateway.html) 섹션을 참조하세요.
### `delete-portal`
다음 코드 예시에서는 `delete-portal`의 사용 방법을 보여줍니다.
**AWS CLI**
**포털 삭제**
다음 `delete-portal` 예시에서는 풍력 발전 단지 회사의 웹 포털을 삭제합니다.
```
aws iotsitewise delete-portal \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE
```
출력:
```
{
"portalStatus": {
"state": "DELETING"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Deleting a portal](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-delete-portal)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeletePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-portal.html) 섹션을 참조하세요.
### `delete-project`
다음 코드 예시에서는 `delete-project`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트 삭제**
다음 `delete-project` 예시에서는 풍력 발전 단지 프로젝트를 삭제합니다.
```
aws iotsitewise delete-project \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Deleting projects](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-projects.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/delete-project.html) 섹션을 참조하세요.
### `describe-access-policy`
다음 코드 예시에서는 `describe-access-policy`의 사용 방법을 보여줍니다.
**AWS CLI**
**액세스 정책을 설명하는 방법**
다음 `describe-access-policy` 예시에서는 풍력 발전 단지 회사의 웹 포털에 대한 사용자 관리 액세스 권한을 부여하는 액세스 정책을 설명합니다.
```
aws iotsitewise describe-access-policy \
--access-policy-id a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE
```
출력:
```
{
"accessPolicyId": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE",
"accessPolicyArn": "arn:aws:iotsitewise:us-west-2:123456789012:access-policy/a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE",
"accessPolicyIdentity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"accessPolicyResource": {
"portal": {
"id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE"
}
},
"accessPolicyPermission": "ADMINISTRATOR",
"accessPolicyCreationDate": "2020-02-20T22:35:15.552880124Z",
"accessPolicyLastUpdateDate": "2020-02-20T22:35:15.552880124Z"
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Adding or removing portal administrators](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-access-policy.html) 섹션을 참조하세요.
### `describe-asset-model`
다음 코드 예시에서는 `describe-asset-model`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 모델을 설명하는 방법**
다음 `describe-asset-model` 예시에서는 풍력 발전 단지 자산 모델을 설명합니다.
```
aws iotsitewise describe-asset-model \
--asset-model-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE
```
출력:
```
{
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetModelName": "Wind Farm Model",
"assetModelDescription": "Represents a wind farm that comprises many wind turbines",
"assetModelProperties": [
{
"id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"name": "Total Generated Power",
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"metric": {
"expression": "sum(power)",
"variables": [
{
"name": "power",
"value": {
"propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE",
"hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
}
},
{
"id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE",
"name": "Region",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": " "
}
}
}
],
"assetModelHierarchies": [
{
"id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"name": "Wind Turbines",
"childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
],
"assetModelCreationDate": 1575671284.0,
"assetModelLastUpdateDate": 1575671988.0,
"assetModelStatus": {
"state": "ACTIVE"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Describing a specific asset model](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset-model)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset-model.html) 섹션을 참조하세요.
### `describe-asset-property`
다음 코드 예시에서는 `describe-asset-property`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 속성을 설명하는 방법**
다음 `describe-asset-property` 예시에서는 풍력 발전 단지 자산의 총 생성 전력 속성을 설명합니다.
```
aws iotsitewise describe-asset-property \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-99999EXAMPLE
```
출력:
```
{
"assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"assetName": "Wind Farm 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetProperty": {
"id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"name": "Total Generated Power",
"notification": {
"topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"state": "DISABLED"
},
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"metric": {
"expression": "sum(power)",
"variables": [
{
"name": "power",
"value": {
"propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE",
"hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
}
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Describing a specific asset property](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset-property)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeAssetProperty](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset-property.html) 섹션을 참조하세요.
### `describe-asset`
다음 코드 예시에서는 `describe-asset`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산을 설명하는 방법**
다음 `describe-asset` 예시에서는 풍력 발전 단지 자산을 설명합니다.
```
aws iotsitewise describe-asset \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE
```
출력:
```
{
"assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"assetArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"assetName": "Wind Farm 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetProperties": [
{
"id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE",
"name": "Region",
"dataType": "STRING"
},
{
"id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"name": "Total Generated Power",
"dataType": "DOUBLE",
"unit": "kW"
}
],
"assetHierarchies": [
{
"id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"name": "Wind Turbines"
}
],
"assetCreationDate": 1575672453.0,
"assetLastUpdateDate": 1575672453.0,
"assetStatus": {
"state": "ACTIVE"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Describing a specific asset](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#describe-asset)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-asset.html) 섹션을 참조하세요.
### `describe-dashboard`
다음 코드 예시에서는 `describe-dashboard`의 사용 방법을 보여줍니다.
**AWS CLI**
**대시보드를 설명하는 방법**
다음 `describe-dashboard` 예시에서는 지정된 풍력 발전 단지 대시보드를 설명합니다.
```
aws iotsitewise describe-dashboard \
--dashboard-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE
```
출력:
```
{
"dashboardId": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE",
"dashboardArn": "arn:aws:iotsitewise:us-west-2:123456789012:dashboard/a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE",
"dashboardName": "Wind Farm",
"projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"dashboardDefinition": "{\"widgets\":[{\"type\":\"monitor-line-chart\",\"title\":\"Generated Power\",\"x\":0,\"y\":0,\"height\":3,\"width\":3,\"metrics\":[{\"label\":\"Power\",\"type\":\"iotsitewise\",\"assetId\":\"a1b2c3d4-5678-90ab-cdef-44444EXAMPLE\",\"propertyId\":\"a1b2c3d4-5678-90ab-cdef-99999EXAMPLE\"}]}]}",
"dashboardCreationDate": "2020-05-01T20:32:12.228476348Z",
"dashboardLastUpdateDate": "2020-05-01T20:32:12.228476348Z"
}
```
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Viewing dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-dashboards.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-dashboard.html) 섹션을 참조하세요.
### `describe-gateway-capability-configuration`
다음 코드 예시에서는 `describe-gateway-capability-configuration`의 사용 방법을 보여줍니다.
**AWS CLI**
**게이트웨이 기능을 설명하는 방법**
다음 `describe-gateway-capability-configuration` 예시에서는 OPC-UA 소스 기능에 대해 설명합니다.
```
aws iotsitewise describe-gateway-capability-configuration \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
--capability-namespace "iotsitewise:opcuacollector:1"
```
출력:
```
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilityConfiguration": "{\"sources\":[{\"name\":\"Wind Farm #1\",\"endpoint\":{\"certificateTrust\":{\"type\":\"TrustAny\"},\"endpointUri\":\"opc.tcp://203.0.113.0:49320\",\"securityPolicy\":\"BASIC256\",\"messageSecurityMode\":\"SIGN_AND_ENCRYPT\",\"identityProvider\":{\"type\":\"Username\",\"usernameSecretArn\":\"arn:aws:secretsmanager:us-east-1:123456789012:secret:greengrass-factory1-auth-3QNDmM\"},\"nodeFilterRules\":[]},\"measurementDataStreamPrefix\":\"\"}]}",
"capabilitySyncStatus": "IN_SYNC"
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Configuring data sources](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-sources.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeGatewayCapabilityConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-gateway-capability-configuration.html) 섹션을 참조하세요.
### `describe-gateway`
다음 코드 예시에서는 `describe-gateway`의 사용 방법을 보여줍니다.
**AWS CLI**
**게이트웨이를 설명하는 방법**
다음 `describe-gateway` 예시에서는 게이트웨이를 설명합니다.
```
aws iotsitewise describe-gateway \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE
```
출력:
```
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayName": "ExampleCorpGateway",
"gatewayArn": "arn:aws:iotsitewise:us-west-2:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayPlatform": {
"greengrass": {
"groupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-1b1b1EXAMPLE"
}
},
"gatewayCapabilitySummaries": [
{
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilitySyncStatus": "IN_SYNC"
}
],
"creationDate": 1588369971.457,
"lastUpdateDate": 1588369971.457
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Ingesting data using a gateway](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-gateway.html) 섹션을 참조하세요.
### `describe-logging-options`
다음 코드 예시에서는 `describe-logging-options`의 사용 방법을 보여줍니다.
**AWS CLI**
**현재 AWS IoT SiteWise 로깅 옵션을 검색하는 방법**
다음 `describe-logging-options` 예시에서는 현재 리전의 AWS 계정에 대한 현재 AWS IoT SiteWise 로깅 옵션을 검색합니다.
```
aws iotsitewise describe-logging-options
```
출력:
```
{
"loggingOptions": {
"level": "INFO"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Monitoring AWS IoT SiteWise with Amazon CloudWatch Logs](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-logs.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-logging-options.html) 섹션을 참조하세요.
### `describe-portal`
다음 코드 예시에서는 `describe-portal`의 사용 방법을 보여줍니다.
**AWS CLI**
**포털을 설명하는 방법**
다음 `describe-portal` 예시에서는 풍력 발전 단지 회사의 웹 포털에 대해 설명합니다.
```
aws iotsitewise describe-portal \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE
```
출력:
```
{
"portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"portalArn": "arn:aws:iotsitewise:us-west-2:123456789012:portal/a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"portalName": "WindFarmPortal",
"portalDescription": "A portal that contains wind farm projects for Example Corp.",
"portalClientId": "E-a1b2c3d4e5f6_a1b2c3d4e5f6EXAMPLE",
"portalStartUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws",
"portalContactEmail": "support@example.com",
"portalStatus": {
"state": "ACTIVE"
},
"portalCreationDate": "2020-02-04T23:01:52.90248068Z",
"portalLastUpdateDate": "2020-02-04T23:01:52.90248078Z",
"roleArn": "arn:aws:iam::123456789012:role/MySiteWiseMonitorServiceRole"
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Administering your portals](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-portal.html) 섹션을 참조하세요.
### `describe-project`
다음 코드 예시에서는 `describe-project`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트 설명**
다음 `describe-project` 예시에서는 풍력 발전 단지 프로젝트를 설명합니다.
```
aws iotsitewise describe-project \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE
```
출력:
```
{
"projectId": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"projectArn": "arn:aws:iotsitewise:us-west-2:123456789012:project/a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"projectName": "Wind Farm 1",
"portalId": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"projectDescription": "Contains asset visualizations for Wind Farm #1 for Example Corp.",
"projectCreationDate": "2020-02-20T21:58:43.362246001Z",
"projectLastUpdateDate": "2020-02-20T21:58:43.362246095Z"
}
```
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Viewing project details](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-project-details.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/describe-project.html) 섹션을 참조하세요.
### `disassociate-assets`
다음 코드 예시에서는 `disassociate-assets`의 사용 방법을 보여줍니다.
**AWS CLI**
**상위 자산에서 하위 자산을 연결 해제하는 방법**
다음 `disassociate-assets` 예시에서는 풍력 터빈 자산을 풍력 발전 단지 자산과 연결 해제합니다.
```
aws iotsitewise disassociate-assets \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \
--hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE \
--child-asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Associating assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/add-associated-assets.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DisassociateAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/disassociate-assets.html) 섹션을 참조하세요.
### `get-asset-property-aggregates`
다음 코드 예시에서는 `get-asset-property-aggregates`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 속성의 집계된 평균 및 개수 값을 검색하는 방법**
다음 `get-asset-property-aggregates` 예시에서는 1시간 동안 풍력 터빈 자산의 평균 총 전력과 총 전력 데이터 포인트 수를 검색합니다.
```
aws iotsitewise get-asset-property-aggregates \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \
--start-date 1580849400 \
--end-date 1580853000 \
--aggregate-types AVERAGE COUNT \
--resolution 1h
```
출력:
```
{
"aggregatedValues": [
{
"timestamp": 1580850000.0,
"quality": "GOOD",
"value": {
"average": 8723.46538886233,
"count": 12.0
}
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Querying asset property aggregates](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#aggregates)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetAssetPropertyAggregates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-aggregates.html) 섹션을 참조하세요.
### `get-asset-property-value-history`
다음 코드 예시에서는 `get-asset-property-value-history`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 속성의 기록 값을 검색하는 방법**
다음 `get-asset-property-value-history` 예시에서는 20분 동안 풍력 터빈 자산의 총 전력 값을 검색합니다.
```
aws iotsitewise get-asset-property-value-history \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \
--start-date 1580851800 \
--end-date 1580853000
```
출력:
```
{
"assetPropertyValueHistory": [
{
"value": {
"doubleValue": 7217.787046814844
},
"timestamp": {
"timeInSeconds": 1580852100,
"offsetInNanos": 0
},
"quality": "GOOD"
},
{
"value": {
"doubleValue": 6941.242811875451
},
"timestamp": {
"timeInSeconds": 1580852400,
"offsetInNanos": 0
},
"quality": "GOOD"
},
{
"value": {
"doubleValue": 6976.797662266717
},
"timestamp": {
"timeInSeconds": 1580852700,
"offsetInNanos": 0
},
"quality": "GOOD"
},
{
"value": {
"doubleValue": 6890.8677520453875
},
"timestamp": {
"timeInSeconds": 1580853000,
"offsetInNanos": 0
},
"quality": "GOOD"
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Querying historical asset property values](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#historical-values)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetAssetPropertyValueHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-value-history.html) 섹션을 참조하세요.
### `get-asset-property-value`
다음 코드 예시에서는 `get-asset-property-value`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 속성의 현재 값을 검색하는 방법**
다음 `get-asset-property-value` 예시에서는 풍력 터빈 자산의 현재 총 전력을 검색합니다.
```
aws iotsitewise get-asset-property-value \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE
```
출력:
```
{
"propertyValue": {
"value": {
"doubleValue": 6890.8677520453875
},
"timestamp": {
"timeInSeconds": 1580853000,
"offsetInNanos": 0
},
"quality": "GOOD"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Querying current asset property values](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#current-values)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetAssetPropertyValue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/get-asset-property-value.html) 섹션을 참조하세요.
### `list-access-policies`
다음 코드 예시에서는 `list-access-policies`의 사용 방법을 보여줍니다.
**AWS CLI**
**모든 액세스 정책 나열**
다음 `list-access-policies` 예시에서는 포털 관리자인 사용자의 모든 액세스 정책을 나열합니다.
```
aws iotsitewise list-access-policies \
--identity-type USER \
--identity-id a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE
```
출력:
```
{
"accessPolicySummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-cccccEXAMPLE",
"identity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"resource": {
"portal": {
"id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE"
}
},
"permission": "ADMINISTRATOR"
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Administering your portals](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListAccessPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-access-policies.html) 섹션을 참조하세요.
### `list-asset-models`
다음 코드 예시에서는 `list-asset-models`의 사용 방법을 보여줍니다.
**AWS CLI**
**모든 자산 모델 나열**
다음 `list-asset-models` 예시에서는 현재 리전의 AWS 계정에 정의된 모든 자산 모델을 나열합니다.
```
aws iotsitewise list-asset-models
```
출력:
```
{
"assetModelSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"name": "Wind Farm Model",
"description": "Represents a wind farm that comprises many wind turbines",
"creationDate": 1575671284.0,
"lastUpdateDate": 1575671988.0,
"status": {
"state": "ACTIVE"
}
},
{
"id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"name": "Wind Turbine Model",
"description": "Represents a wind turbine manufactured by Example Corp",
"creationDate": 1575671207.0,
"lastUpdateDate": 1575686273.0,
"status": {
"state": "ACTIVE"
}
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Listing all asset models](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-asset-models)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListAssetModels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-asset-models.html) 섹션을 참조하세요.
### `list-assets`
다음 코드 예시에서는 `list-assets`의 사용 방법을 보여줍니다.
**AWS CLI**
**예시 1: 모든 최상위 자산 나열**
다음 `list-assets` 예시에서는 자산 계층 구조 트리에서 최상위 수준이고 현재 리전의 AWS 계정에 정의된 모든 자산을 나열합니다.
```
aws iotsitewise list-assets \
--filter TOP_LEVEL
```
출력:
```
{
"assetSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"name": "Wind Farm 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"creationDate": 1575672453.0,
"lastUpdateDate": 1575672453.0,
"status": {
"state": "ACTIVE"
},
"hierarchies": [
{
"id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"name": "Wind Turbines"
}
]
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Listing assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-assets)를 참조하세요.
**예시 2: 자산 모델을 기반으로 모든 자산 나열**
다음 `list-assets` 예시에서는 자산 모델을 기반으로 현재 리전의 AWS 계정에 정의된 모든 자산을 나열합니다.
```
aws iotsitewise list-assets \
--asset-model-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
```
출력:
```
{
"assetSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"name": "Wind Turbine 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"creationDate": 1575671550.0,
"lastUpdateDate": 1575686308.0,
"status": {
"state": "ACTIVE"
},
"hierarchies": []
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Listing assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-assets)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-assets.html) 섹션을 참조하세요.
### `list-associated-assets`
다음 코드 예시에서는 `list-associated-assets`의 사용 방법을 보여줍니다.
**AWS CLI**
**특정 계층 구조의 자산에 연결된 모든 자산 나열**
다음 `list-associated-assets` 예시에서는 지정된 풍력 발전 단지 자산과 연결된 모든 풍력 터빈 자산을 나열합니다.
```
aws iotsitewise list-associated-assets \
--asset-id a1b2c3d4-5678-90ab-cdef-44444EXAMPLE \
--hierarchy-id a1b2c3d4-5678-90ab-cdef-77777EXAMPLE
```
출력:
```
{
"assetSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"arn": "arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"name": "Wind Turbine 1",
"assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"creationDate": 1575671550.0,
"lastUpdateDate": 1575686308.0,
"status": {
"state": "ACTIVE"
},
"hierarchies": []
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Listing assets associated to a specific asset](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/discover-asset-resources.html#list-associated-assets)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListAssociatedAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-associated-assets.html) 섹션을 참조하세요.
### `list-dashboards`
다음 코드 예시에서는 `list-dashboards`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트의 모든 대시보드를 나열하는 방법**
다음 `list-dashboards` 예시에서는 프로젝트에 정의된 모든 대시보드를 나열합니다.
```
aws iotsitewise list-dashboards \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE
```
출력:
```
{
"dashboardSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE",
"name": "Wind Farm",
"creationDate": "2020-05-01T20:32:12.228476348Z",
"lastUpdateDate": "2020-05-01T20:32:12.228476348Z"
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Viewing dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-dashboards.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-dashboards.html) 섹션을 참조하세요.
### `list-gateways`
다음 코드 예시에서는 `list-gateways`의 사용 방법을 보여줍니다.
**AWS CLI**
**모든 게이트웨이를 나열하는 방법**
다음 `list-gateways` 예시에서는 현재 리전의 AWS 계정에 정의된 모든 게이트웨이를 나열합니다.
```
aws iotsitewise list-gateways
```
출력:
```
{
"gatewaySummaries": [
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayName": "ExampleCorpGateway",
"gatewayCapabilitySummaries": [
{
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilitySyncStatus": "IN_SYNC"
}
],
"creationDate": 1588369971.457,
"lastUpdateDate": 1588369971.457
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Ingesting data using a gateway](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-gateways.html) 섹션을 참조하세요.
### `list-portals`
다음 코드 예시에서는 `list-portals`의 사용 방법을 보여줍니다.
**AWS CLI**
**모든 포털을 나열하는 방법**
다음 `list-portals` 예시에서는 현재 리전 내 AWS 계정의 모든 유지 관리 기간을 나열합니다.
```
aws iotsitewise list-portals
```
출력:
```
{
"portalSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE",
"name": "WindFarmPortal",
"description": "A portal that contains wind farm projects for Example Corp.",
"startUrl": "https://a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE.app.iotsitewise.aws",
"creationDate": "2020-02-04T23:01:52.90248068Z",
"lastUpdateDate": "2020-02-04T23:01:52.90248078Z",
"roleArn": "arn:aws:iam::123456789012:role/service-role/MySiteWiseMonitorServiceRole"
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Administering your portals](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListPortals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-portals.html) 섹션을 참조하세요.
### `list-project-assets`
다음 코드 예시에서는 `list-project-assets`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트에 연결된 모든 자산을 나열하는 방법**
다음 `list-project-assets` 예시에서는 풍력 발전 단지 프로젝트와 연결된 모든 자산을 나열합니다.
```
aws iotsitewise list-projects \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE
```
출력:
```
{
"assetIds": [
"a1b2c3d4-5678-90ab-cdef-44444EXAMPLE"
]
}
```
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Adding assets to projects](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/add-assets-to-projects-sd.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListProjectAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-project-assets.html) 섹션을 참조하세요.
### `list-projects`
다음 코드 예시에서는 `list-projects`의 사용 방법을 보여줍니다.
**AWS CLI**
**포털의 모든 프로젝트를 나열하는 방법**
다음 `list-projects` 예시에서는 포털에 정의된 모든 프로젝트를 나열합니다.
```
aws iotsitewise list-projects \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE
```
출력:
```
{
"projectSummaries": [
{
"id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE",
"name": "Wind Farm 1",
"description": "Contains asset visualizations for Wind Farm #1 for Example Corp.",
"creationDate": "2020-02-20T21:58:43.362246001Z",
"lastUpdateDate": "2020-02-20T21:58:43.362246095Z"
}
]
}
```
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Viewing project details](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-project-details.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListProjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-projects.html) 섹션을 참조하세요.
### `list-tags-for-resource`
다음 코드 예시에서는 `list-tags-for-resource`의 사용 방법을 보여줍니다.
**AWS CLI**
**리소스의 모든 태그 나열**
다음 `list-tags-for-resource` 예시에서는 풍력 터빈 자산의 모든 태그를 나열합니다.
```
aws iotsitewise list-tags-for-resource \
--resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
```
출력:
```
{
"tags": {
"Owner": "richard-roe"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Tagging your resources](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/list-tags-for-resource.html)를 참조하세요.
### `put-logging-options`
다음 코드 예시에서는 `put-logging-options`의 사용 방법을 보여줍니다.
**AWS CLI**
**로깅 수준을 지정하는 방법**
다음 `put-logging-options` 예시에서는 AWS IoT SiteWise 에서 `INFO` 수준 로깅을 활성화합니다. 다른 수준에는 `DEBUG` 및 `OFF`가 포함됩니다.
```
aws iotsitewise put-logging-options \
--logging-options level=INFO
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Monitoring AWS IoT SiteWise with Amazon CloudWatch Logs](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-cloudwatch-logs.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [PutLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/put-logging-options.html) 섹션을 참조하세요.
### `tag-resource`
다음 코드 예시에서는 `tag-resource`의 사용 방법을 보여줍니다.
**AWS CLI**
**리소스에 태그 추가**
다음 `tag-resource` 예시에서는 풍력 터빈 자산에 소유자 태그를 추가합니다. 이를 통해 자산 소유자에 따라 자산에 대한 액세스를 제어할 수 있습니다.
```
aws iotsitewise tag-resource \
--resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--tags Owner=richard-roe
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Tagging your resources](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/tag-resource.html)를 참조하세요.
### `untag-resource`
다음 코드 예시에서는 `untag-resource`의 사용 방법을 보여줍니다.
**AWS CLI**
**리소스에서 태그 제거**
다음 `untag-resource` 예시에서는 풍력 터빈 자산에서 소유자 태그를 제거합니다.
```
aws iotsitewise untag-resource \
--resource-arn arn:aws:iotsitewise:us-west-2:123456789012:asset/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--tag-keys Owner
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Tagging your resources](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/untag-resource.html)를 참조하세요.
### `update-access-policy`
다음 코드 예시에서는 `update-access-policy`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트 시청자에게 프로젝트의 소유권을 부여하는 방법**
다음 `update-access-policy` 예시에서는 프로젝트 뷰어에게 프로젝트의 소유권을 부여하는 액세스 정책을 업데이트합니다.
```
aws iotsitewise update-access-policy \
--access-policy-id a1b2c3d4-5678-90ab-cdef-dddddEXAMPLE \
--cli-input-json file://update-project-viewer-access-policy.json
```
`update-project-viewer-access-policy.json`의 콘텐츠:
```
{
"accessPolicyIdentity": {
"user": {
"id": "a1b2c3d4e5-a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE"
}
},
"accessPolicyPermission": "ADMINISTRATOR",
"accessPolicyResource": {
"project": {
"id": "a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE"
}
}
}
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Assigning project owners](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/assign-project-owners.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-access-policy.html) 섹션을 참조하세요.
### `update-asset-model`
다음 코드 예시에서는 `update-asset-model`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산 모델 생성**
다음 `update-asset-model` 예시에서는 풍력 발전소 자산 모델의 설명을 업데이트합니다. 이 예시에는 `update-asset-model`이 기존 모델을 새 모델로 덮어쓰기 때문에 모델의 기존 ID와 정의가 포함되어 있습니다.
```
aws iotsitewise update-asset-model \
--cli-input-json file://update-wind-farm-model.json
```
`update-wind-farm-model.json`의 콘텐츠:
```
{
"assetModelName": "Wind Farm Model",
"assetModelDescription": "Represents a wind farm that comprises many wind turbines",
"assetModelProperties": [
{
"id": "a1b2c3d4-5678-90ab-cdef-88888EXAMPLE",
"name": "Region",
"dataType": "STRING",
"type": {
"attribute": {}
}
},
{
"id": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE",
"name": "Total Generated Power",
"dataType": "DOUBLE",
"unit": "kW",
"type": {
"metric": {
"expression": "sum(power)",
"variables": [
{
"name": "power",
"value": {
"hierarchyId": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-66666EXAMPLE"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
}
}
],
"assetModelHierarchies": [
{
"id": "a1b2c3d4-5678-90ab-cdef-77777EXAMPLE",
"name": "Wind Turbines",
"childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
]
}
```
출력:
```
{
"assetModelId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetModelArn": "arn:aws:iotsitewise:us-west-2:123456789012:asset-model/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"assetModelStatus": {
"state": "CREATING"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Updating asset models](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-assets-and-models.html#update-asset-models)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateAssetModel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset-model.html) 섹션을 참조하세요.
### `update-asset-property`
다음 코드 예시에서는 `update-asset-property`의 사용 방법을 보여줍니다.
**AWS CLI**
**예시 1: 자산 속성의 별칭 업데이트**
다음 `update-asset-property` 예시에서는 풍력 터빈 자산의 전력 속성 별칭을 업데이트합니다.
```
aws iotsitewise update-asset-property \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-55555EXAMPLE \
--property-alias "/examplecorp/windfarm/1/turbine/1/power" \
--property-notification-state DISABLED
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Mapping industrial data streams to asset properties](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html)를 참조하세요.
**예시 2: 자산 속성 알림 활성화**
다음 `update-asset-property` 예시에서는 풍력 터빈 자산의 전력 속성에 대한 자산 속성 업데이트 알림을 활성화합니다. 속성 값 업데이트는 MQTT 주제 `$aws/sitewise/asset-models//assets//properties/`에 게시되며, 여기서 각 ID는 자산 속성의 속성, 자산 및 모델 ID로 대체됩니다.
```
aws iotsitewise update-asset-property \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--property-id a1b2c3d4-5678-90ab-cdef-66666EXAMPLE \
--property-notification-state ENABLED \
--property-alias "/examplecorp/windfarm/1/turbine/1/power"
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Interacting with other services](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateAssetProperty](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset-property.html) 섹션을 참조하세요.
### `update-asset`
다음 코드 예시에서는 `update-asset`의 사용 방법을 보여줍니다.
**AWS CLI**
**자산의 이름 업데이트**
다음 `update-asset` 예시에서는 풍력 터빈 자산의 이름을 업데이트합니다.
```
aws iotsitewise update-asset \
--asset-id a1b2c3d4-5678-90ab-cdef-33333EXAMPLE \
--asset-name "Wind Turbine 2"
```
출력:
```
{
"assetStatus": {
"state": "UPDATING"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Updating assets](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-assets-and-models.html#update-assets)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-asset.html) 섹션을 참조하세요.
### `update-dashboard`
다음 코드 예시에서는 `update-dashboard`의 사용 방법을 보여줍니다.
**AWS CLI**
**대시보드 업데이트**
다음 `update-dashboard` 예시에서는 풍력 발전 단지의 총 발전량을 표시하는 대시보드의 꺾은선형 차트의 제목을 변경합니다.
```
aws iotsitewise update-dashboard \
--project-id a1b2c3d4-5678-90ab-cdef-fffffEXAMPLE \
--dashboard-name "Wind Farm" \
--dashboard-definition file://update-wind-farm-dashboard.json
```
`update-wind-farm-dashboard.json`의 콘텐츠:
```
{
"widgets": [
{
"type": "monitor-line-chart",
"title": "Total Generated Power",
"x": 0,
"y": 0,
"height": 3,
"width": 3,
"metrics": [
{
"label": "Power",
"type": "iotsitewise",
"assetId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-99999EXAMPLE"
}
]
}
]
}
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Creating dashboards (CLI)](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-dashboards-using-aws-cli.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-dashboard.html) 섹션을 참조하세요.
### `update-gateway-capability-configuration`
다음 코드 예시에서는 `update-gateway-capability-configuration`의 사용 방법을 보여줍니다.
**AWS CLI**
**게이트웨이 기능을 업데이트하는 방법**
다음 `update-gateway-capability-configuration` 예시에서는 다음 속성을 사용하여 OPC-UA 소스를 구성합니다
모든 인증서를 신뢰합니다.Basic256 알고리즘을 사용하여 메시지를 보호합니다. 서명 및 암호화 모드를 사용하여 연결을 보호합니다. AWS Secrets Manager 암호에 저장된 인증 자격 증명을 사용합니다.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
--capability-namespace "iotsitewise:opcuacollector:1" \
--capability-configuration file://opc-ua-capability-configuration.json
```
`opc-ua-capability-configuration.json`의 콘텐츠:
```
{
"sources": [
{
"name": "Wind Farm #1",
"endpoint": {
"certificateTrust": {
"type": "TrustAny"
},
"endpointUri": "opc.tcp://203.0.113.0:49320",
"securityPolicy": "BASIC256",
"messageSecurityMode": "SIGN_AND_ENCRYPT",
"identityProvider": {
"type": "Username",
"usernameSecretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-windfarm1-auth-1ABCDE"
},
"nodeFilterRules": []
},
"measurementDataStreamPrefix": ""
}
]
}
```
출력:
```
{
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilitySyncStatus": "OUT_OF_SYNC"
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Configuring data sources](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-sources.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateGatewayCapabilityConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-gateway-capability-configuration.html) 섹션을 참조하세요.
### `update-gateway`
다음 코드 예시에서는 `update-gateway`의 사용 방법을 보여줍니다.
**AWS CLI**
**게이트웨이의 이름 업데이트**
다음 `update-gateway` 예시에서는 게이트웨이의 이름을 업데이트합니다.
```
aws iotsitewise update-gateway \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
--gateway-name ExampleCorpGateway1
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Ingesting data using a gateway](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-gateway.html) 섹션을 참조하세요.
### `update-portal`
다음 코드 예시에서는 `update-portal`의 사용 방법을 보여줍니다.
**AWS CLI**
**포털의 세부 정보를 업데이트하는 방법**
다음 `update-portal` 예시에서는 풍력 발전 단지 회사의 웹 포털을 업데이트합니다.
```
aws iotsitewise update-portal \
--portal-id a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE \
--portal-name WindFarmPortal \
--portal-description "A portal that contains wind farm projects for Example Corp." \
--portal-contact-email support@example.com \
--role-arn arn:aws:iam::123456789012:role/MySiteWiseMonitorServiceRole
```
출력:
```
{
"portalStatus": {
"state": "UPDATING"
}
}
```
자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [Administering your portals](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdatePortal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-portal.html) 섹션을 참조하세요.
### `update-project`
다음 코드 예시에서는 `update-project`의 사용 방법을 보여줍니다.
**AWS CLI**
**프로젝트 세부 정보를 업데이트하는 방법**
다음 `update-project` 예시에서는 풍력 발전 단지 프로젝트를 업데이트합니다.
```
aws iotsitewise update-project \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--project-name "Wind Farm 1" \
--project-description "Contains asset visualizations for Wind Farm #1 for Example Corp."
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *AWS IoT SiteWise 모니터 애플리케이션 설명서*의 [Changing project details](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/edit-project-details.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-project.html) 섹션을 참조하세요.