이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS IoT Things Graph 사용 예제 AWS CLI
다음 코드 예제에서는 AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 AWS IoT Things Graph.
작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.
주제
작업
다음 코드 예시에서는 associate-entity-to-thing
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
사물을 디바이스와 연결하려면
다음
associate-entity-to-thing
예제에서는 사물을 디바이스와 연결합니다. 이 예제에서는 퍼블릭 네임스페이스에 있는 모션 센서 디바이스를 사용합니다.aws iotthingsgraph associate-entity-to-thing \ --thing-name
"MotionSensorName"
\ --entity-id"urn:tdm:aws/examples:Device:HCSR501MotionSensor"
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 모델 생성 및 업로드를 참조하세요.
-
자세한 API 내용은 명령 참조AssociateEntityToThing
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 create-flow-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름을 생성하려면
다음
create-flow-template
예제에서는 흐름(워크플로)을 생성합니다. 의 값은 흐름을 모델링하는 GraphQLMyFlowDefinition
입니다.aws iotthingsgraph create-flow-template \ --definition language=GRAPHQL,text="MyFlowDefinition"
출력:
{ "summary": { "createdAt": 1559248067.545, "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 1 } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 흐름 작업을 참조하세요.
-
자세한 API 내용은 명령 참조CreateFlowTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 create-system-instance
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템 인스턴스를 생성하려면
다음
create-system-instance
예제에서는 시스템 인스턴스를 생성합니다. 의 값은 시스템 인스턴스를 모델링하는 GraphQLMySystemInstanceDefinition
입니다.aws iotthingsgraph create
-
system-instance -\-definition
language=GRAPHQL,text="MySystemInstanceDefinition" \ --targetCLOUD
\ --flow-actions-role-arnmyRoleARN
출력:
{ "summary": { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", "status": "NOT_DEPLOYED", "target": "CLOUD", "createdAt": 1559249315.208, "updatedAt": 1559249315.208 } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 및 흐름 구성 작업을 참조하세요.
-
자세한 API 내용은 명령 참조CreateSystemInstance
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 create-system-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템을 생성하려면
다음
create-system-template
예제에서는 시스템을 생성합니다. 의 값은 시스템을 모델링하는 GraphQL MySystemDefinition 입니다.aws iotthingsgraph create-system-template \ --definition language=GRAPHQL,text="MySystemDefinition"
출력:
{ "summary": { "createdAt": 1559249776.254, "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", "revisionNumber": 1 } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 생성을 참조하세요.
-
자세한 API 내용은 명령 참조CreateSystemTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-flow-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름을 삭제하려면
다음
delete-flow-template
예제에서는 흐름(워크플로)을 삭제합니다.aws iotthingsgraph delete-flow-template \ --id
"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow"
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 개체, 흐름, 시스템 및 배포의 수명 주기 관리를 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조DeleteFlowTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-namespace
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
네임스페이스를 삭제하려면
다음
delete-namespace
예제에서는 네임스페이스를 삭제합니다.aws iotthingsgraph delete-namespace
출력:
{ "namespaceArn": "arn:aws:iotthingsgraph:us-west-2:123456789012", "namespaceName": "us-west-2/123456789012/default" }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 개체, 흐름, 시스템 및 배포의 수명 주기 관리를 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조DeleteNamespace
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-system-instance
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템 인스턴스를 삭제하려면
다음
delete-system-instance
예제에서는 시스템 인스턴스를 삭제합니다.aws iotthingsgraph delete-system-instance \ --id
"urn:tdm:us-west-2/123456789012/default:Deployment:Room218"
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 개체, 흐름, 시스템 및 배포의 수명 주기 관리를 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조DeleteSystemInstance
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-system-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템을 삭제하려면
다음
delete-system-template
예제에서는 시스템을 삭제합니다.aws iotthingsgraph delete-system-template \ --id
"urn:tdm:us-west-2/123456789012/default:System:MySystem"
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 개체, 흐름, 시스템 및 배포의 수명 주기 관리를 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조DeleteSystemTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 deploy-system-instance
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템 인스턴스를 배포하려면
다음
delete-system-template
예제에서는 시스템 인스턴스를 배포합니다.aws iotthingsgraph deploy-system-instance \ --id
"urn:tdm:us-west-2/123456789012/default:Deployment:Room218"
출력:
{ "summary": { "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment:Room218", "createdAt": 1559249776.254, "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", "status": "DEPLOYED_IN_TARGET", "target": "CLOUD", "updatedAt": 1559249776.254 } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 및 흐름 구성 작업을 참조하세요.
-
자세한 API 내용은 명령 참조DeploySystemInstance
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 deprecate-flow-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름 사용을 중단하려면
다음
deprecate-flow-template
예제에서는 흐름(워크플로)을 사용 중지합니다.aws iotthingsgraph deprecate-flow-template \ --id
"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow"
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 개체, 흐름, 시스템 및 배포의 수명 주기 관리를 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조DeprecateFlowTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 deprecate-system-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템 사용을 중단하려면
다음
deprecate-system-template
예제에서는 시스템의 사용을 중단합니다.aws iotthingsgraph deprecate-system-template \ --id
"urn:tdm:us-west-2/123456789012/default:System:MySystem"
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 개체, 흐름, 시스템 및 배포의 수명 주기 관리를 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조DeprecateSystemTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-namespace
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
네임스페이스에 대한 설명을 가져오려면
다음
describe-namespace
예제에서는 네임스페이스에 대한 설명을 가져옵니다.aws iotthingsgraph describe-namespace
출력:
{ "namespaceName": "us-west-2/123456789012/default", "trackingNamespaceName": "aws", "trackingNamespaceVersion": 1, "namespaceVersion": 5 }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 네임스페이스를 참조하세요.
-
자세한 API 내용은 명령 참조DescribeNamespace
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 dissociate-entity-from-thing
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
디바이스에서 사물을 연결 해제하려면
다음
dissociate-entity-from-thing
예제에서는 디바이스에서 사물을 분리합니다.aws iotthingsgraph dissociate-entity-from-thing \ --thing-name
"MotionSensorName"
\ --entity-type"DEVICE"
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 모델 생성 및 업로드를 참조하세요.
-
자세한 API 내용은 명령 참조DissociateEntityFromThing
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-entities
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
엔터티에 대한 정의를 가져오려면
다음
get-entities
예제에서는 디바이스 모델에 대한 정의를 가져옵니다.aws iotthingsgraph get-entities \ --ids
"urn:tdm:aws/examples:DeviceModel:MotionSensor"
출력:
{ "descriptions": [ { "id": "urn:tdm:aws/examples:DeviceModel:MotionSensor", "type": "DEVICE_MODEL", "createdAt": 1559256190.599, "definition": { "language": "GRAPHQL", "text": "##\n# Specification of motion sensor devices interface.\n##\ntype MotionSensor @deviceModel(id: \"urn:tdm:aws/examples:deviceModel:MotionSensor\",\n capability: \"urn:tdm:aws/examples:capability:MotionSensorCapability\") {ignore:void}" } } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 모델 생성 및 업로드를 참조하세요.
-
자세한 API 내용은 명령 참조GetEntities
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-flow-template-revisions
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름에 대한 개정 정보를 가져오려면
다음
get-flow-template-revisions
예제에서는 흐름(워크플로)에 대한 개정 정보를 가져옵니다.aws iotthingsgraph get-flow-template-revisions \ --id
urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow
출력:
{ "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 1, "createdAt": 1559247540.292 } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 흐름 작업을 참조하세요.
-
자세한 API 내용은 명령 참조GetFlowTemplateRevisions
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-flow-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름 정의를 가져오려면
다음
get-flow-template
예제에서는 흐름(워크플로)에 대한 정의를 가져옵니다.aws iotthingsgraph get-flow-template \ --id
"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow"
출력:
{ "description": { "summary": { "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 1, "createdAt": 1559247540.292 }, "definition": { "language": "GRAPHQL", "text": "{\nquery MyFlow($camera: string!, $screen: string!) @workflowType(id: \"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow\") @annotation(type: \"tgc:FlowEvent\", id: \"sledged790c1b2bcd949e09da0c9bfc077f79d\", x: 1586, y: 653) @triggers(definition: \"{MotionSensor(description: \\\"\\\") @position(x: 1045, y: 635.6666564941406) {\\n condition(expr: \\\"devices[name == \\\\\\\"motionSensor\\\\\\\"].events[name == \\\\\\\"StateChanged\\\\\\\"].lastEvent\\\")\\n action(expr: \\\"\\\")\\n}}\") {\n variables {\n cameraResult @property(id: \"urn:tdm:aws/examples:property:CameraStateProperty\")\n }\n steps {\n step(name: \"Camera\", outEvent: [\"sledged790c1b2bcd949e09da0c9bfc077f79d\"]) @position(x: 1377, y: 638.6666564941406) {\n DeviceActivity(deviceModel: \"urn:tdm:aws/examples:deviceModel:Camera\", out: \"cameraResult\", deviceId: \"${camera}\") {\n capture\n }\n }\n step(name: \"Screen\", inEvent: [\"sledged790c1b2bcd949e09da0c9bfc077f79d\"]) @position(x: 1675.6666870117188, y: 637.9999847412109) {\n DeviceActivity(deviceModel: \"urn:tdm:aws/examples:deviceModel:Screen\", deviceId: \"${screen}\") {\n display(imageUrl: \"${cameraResult.lastClickedImage}\")\n }\n }\n }\n}\n}" }, "validatedNamespaceVersion": 5 } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 흐름 작업을 참조하세요.
-
자세한 API 내용은 명령 참조GetFlowTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-namespace-deletion-status
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
네임스페이스 삭제 작업의 상태를 가져오려면
다음
get-namespace-deletion-status
예제에서는 네임스페이스 삭제 작업의 상태를 가져옵니다.aws iotthingsgraph get-namespace-deletion-status
출력:
{ "namespaceArn": "arn:aws:iotthingsgraph:us-west-2:123456789012", "namespaceName": "us-west-2/123456789012/default" "status": "SUCCEEDED " }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 네임스페이스를 참조하세요.
-
자세한 API 내용은 명령 참조GetNamespaceDeletionStatus
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-system-instance
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템 인스턴스를 가져오려면
다음
get-system-instance
예제에서는 시스템 인스턴스에 대한 정의를 가져옵니다.aws iotthingsgraph get-system-instance \ --id
"urn:tdm:us-west-2/123456789012/default:Deployment:Room218"
출력:
{ "description": { "summary": { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", "status": "NOT_DEPLOYED", "target": "CLOUD", "createdAt": 1559249315.208, "updatedAt": 1559249315.208 }, "definition": { "language": "GRAPHQL", "text": "{\r\nquery Room218 @deployment(id: \"urn:tdm:us-west-2/123456789012/default:Deployment:Room218\", systemId: \"urn:tdm:us-west-2/123456789012/default:System:SecurityFlow\") {\r\n motionSensor(deviceId: \"MotionSensorName\")\r\n screen(deviceId: \"ScreenName\")\r\n camera(deviceId: \"CameraName\") \r\n triggers {MotionEventTrigger(description: \"a trigger\") { \r\n condition(expr: \"devices[name == 'motionSensor'].events[name == 'StateChanged'].lastEvent\") \r\n action(expr: \"ThingsGraph.startFlow('SecurityFlow', bindings[name == 'camera'].deviceId, bindings[name == 'screen'].deviceId)\")\r\n }\r\n }\r\n }\r\n }" }, "metricsConfiguration": { "cloudMetricEnabled": false }, "validatedNamespaceVersion": 5, "flowActionsRoleArn": "arn:aws:iam::123456789012:role/ThingsGraphRole" } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 및 흐름 구성 작업을 참조하세요.
-
자세한 API 내용은 명령 참조GetSystemInstance
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-system-template-revisions
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템에 대한 개정 정보를 가져오려면
다음
get-system-template-revisions
예제에서는 시스템에 대한 개정 정보를 가져옵니다.aws iotthingsgraph get-system-template-revisions \ --id
"urn:tdm:us-west-2/123456789012/default:System:MySystem"
출력:
{ "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", "revisionNumber": 1, "createdAt": 1559247540.656 } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 및 흐름 구성 작업을 참조하세요.
-
자세한 API 내용은 명령 참조GetSystemTemplateRevisions
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-system-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템을 가져오려면
다음
get-system-template
예제에서는 시스템에 대한 정의를 가져옵니다.aws iotthingsgraph get-system-template \ --id
"urn:tdm:us-west-2/123456789012/default:System:MySystem"
출력:
{ "description": { "summary": { "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MyFlow", "revisionNumber": 1, "createdAt": 1559247540.656 }, "definition": { "language": "GRAPHQL", "text": "{\ntype MySystem @systemType(id: \"urn:tdm:us-west-2/123456789012/default:System:MySystem\", description: \"\") {\n camera: Camera @thing(id: \"urn:tdm:aws/examples:deviceModel:Camera\")\n screen: Screen @thing(id: \"urn:tdm:aws/examples:deviceModel:Screen\")\n motionSensor: MotionSensor @thing(id: \"urn:tdm:aws/examples:deviceModel:MotionSensor\")\n MyFlow: MyFlow @workflow(id: \"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow\")\n}\n}" }, "validatedNamespaceVersion": 5 } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 및 흐름 구성 작업을 참조하세요.
-
자세한 API 내용은 명령 참조GetSystemTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-upload-status
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
엔터티 업로드 상태를 가져오려면
다음
get-upload-status
예제에서는 엔터티 업로드 작업의 상태를 가져옵니다. 의 값은upload-entity-definitions
작업에서 반환되는 ID 값MyUploadId
입니다.aws iotthingsgraph get-upload-status \ --upload-id
"MyUploadId"
출력:
{ "namespaceName": "us-west-2/123456789012/default", "namespaceVersion": 5, "uploadId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", "uploadStatus": "SUCCEEDED" }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 모델링 엔터티를 참조하세요.
-
자세한 API 내용은 명령 참조GetUploadStatus
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-flow-execution-messages
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름 실행의 이벤트에 대한 정보를 가져오려면
다음
list-flow-execution-messages
예제에서는 흐름 실행의 이벤트에 대한 정보를 가져옵니다.aws iotthingsgraph list-flow-execution-messages \ --flow-execution-id
"urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow_2019-05-11T19:39:55.317Z_MotionSensor_69b151ad-a611-42f5-ac21-fe537f9868ad"
출력:
{ "messages": [ { "eventType": "EXECUTION_STARTED", "messageId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", "payload": "Flow execution started", "timestamp": 1559247540.656 } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 흐름 작업을 참조하세요.
-
자세한 API 내용은 명령 참조ListFlowExecutionMessages
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-tags-for-resource
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
리소스의 모든 태그를 나열하려면
다음
list-tags-for-resource
예제에서는 AWS IoT Things Graph 리소스의 모든 태그를 나열합니다.aws iotthingsgraph list-tags-for-resource \ --resource-arn
"arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218"
출력:
{ "tags": [ { "key": "Type", "value": "Residential" } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 리소스 태그 지정을 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조ListTagsForResource
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 search-entities
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
엔터티를 검색하려면
다음
search-entities
예제에서는 유형의 모든 엔터티를 검색합니다EVENT
.aws iotthingsgraph search-entities \ --entity-types
"EVENT"
출력:
{ "descriptions": [ { "id": "urn:tdm:aws/examples:Event:MotionSensorEvent", "type": "EVENT", "definition": { "language": "GRAPHQL", "text": "##\n# Description of events emitted by motion sensor.\n##\ntype MotionSensorEvent @eventType(id: \"urn:tdm:aws/examples:event:MotionSensorEvent\",\n payload: \"urn:tdm:aws/examples:property:MotionSensorStateProperty\") {ignore:void}" } }, { "id": "urn:tdm:us-west-2/123456789012/default:Event:CameraClickedEventV2", "type": "EVENT", "definition": { "language": "GRAPHQL", "text": "type CameraClickedEventV2 @eventType(id: \"urn:tdm:us-west-2/123456789012/default:event:CameraClickedEventV2\",\r\npayload: \"urn:tdm:aws:Property:Boolean\"){ignore:void}" } }, { "id": "urn:tdm:us-west-2/123456789012/default:Event:MotionSensorEventV2", "type": "EVENT", "definition": { "language": "GRAPHQL", "text": "# Event emitted by the motion sensor.\r\ntype MotionSensorEventV2 @eventType(id: \"urn:tdm:us-west-2/123456789012/default:event:MotionSensorEventV2\",\r\npayload: \"urn:tdm:us-west-2/123456789012/default:property:MotionSensorStateProperty2\") {ignore:void}" } } ], "nextToken": "urn:tdm:us-west-2/123456789012/default:Event:MotionSensorEventV2" }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 데이터 모델 참조를 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조SearchEntities
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 search-flow-executions
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름 실행을 검색하려면
다음
search-flow-executions
예제에서는 지정된 시스템 인스턴스에서 흐름의 모든 실행을 검색합니다.aws iotthingsgraph search-flow-executions \ --system-instance-id
"urn:tdm:us-west-2/123456789012/default:Deployment:Room218"
출력:
{ "summaries": [ { "createdAt": 1559247540.656, "flowExecutionId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", "flowTemplateId": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "status": "RUNNING ", "systemInstanceId": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "updatedAt": 1559247540.656 } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 및 흐름 구성 작업을 참조하세요.
-
자세한 API 내용은 명령 참조SearchFlowExecutions
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 search-flow-templates
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름(또는 워크플로)을 검색하려면
다음
search-flow-templates
예제에서는 카메라 디바이스 모델을 포함하는 모든 흐름(워크플로)을 검색합니다.aws iotthingsgraph search-flow-templates \ --filters name="DEVICE_MODEL_ID",value="urn:tdm:aws/examples:DeviceModel:Camera"
출력:
{ "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 1, "createdAt": 1559247540.292 }, { "id": "urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow", "revisionNumber": 3, "createdAt": 1548283099.27 } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 흐름 작업을 참조하세요.
-
자세한 API 내용은 명령 참조SearchFlowTemplates
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 search-system-instances
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템 인스턴스를 검색하려면
다음
search-system-instances
예제에서는 지정된 시스템을 포함하는 모든 시스템 인스턴스를 검색합니다.aws iotthingsgraph search-system-instances \ --filters name="SYSTEM_TEMPLATE_ID",value="urn:tdm:us-west-2/123456789012/default:System:SecurityFlow"
출력:
{ "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:DeploymentForSample", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/DeploymentForSample", "status": "NOT_DEPLOYED", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGrnGr", "createdAt": 1555716314.707, "updatedAt": 1555716314.707 }, { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:MockDeployment", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/MockDeployment", "status": "DELETED_IN_TARGET", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGrnGr", "createdAt": 1549416462.049, "updatedAt": 1549416722.361, "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", "greengrassGroupVersionId": "7365aed7-2d3e-4d13-aad8-75443d45eb05" }, { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:MockDeployment2", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/MockDeployment2", "status": "DEPLOYED_IN_TARGET", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGrnGr", "createdAt": 1549572385.774, "updatedAt": 1549572418.408, "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", "greengrassGroupVersionId": "bfa70ab3-2bf7-409c-a4d4-bc8328ae5b86" }, { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room215", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room215", "status": "NOT_DEPLOYED", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGG", "createdAt": 1547056918.413, "updatedAt": 1547056918.413 }, { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", "status": "NOT_DEPLOYED", "target": "CLOUD", "createdAt": 1559249315.208, "updatedAt": 1559249315.208 } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 및 흐름 구성 작업을 참조하세요.
-
자세한 API 내용은 명령 참조SearchSystemInstances
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 search-system-templates
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템을 검색하려면
다음
search-system-templates
예제에서는 지정된 흐름이 포함된 모든 시스템을 검색합니다.aws iotthingsgraph search-system-templates \ --filters name="FLOW_TEMPLATE_ID",value="urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow"
출력:
{ "summaries": [ { "id": "urn:tdm:us-west-2/123456789012/default:System:SecurityFlow", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/SecurityFlow", "revisionNumber": 1, "createdAt": 1548283099.433 } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 흐름 작업을 참조하세요.
-
자세한 API 내용은 명령 참조SearchSystemTemplates
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 search-things
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
디바이스 및 디바이스 모델과 연결된 사물을 검색하려면
다음
search-things
예제에서는 HCSR501MotionSensor device와 연결된 모든 항목을 검색합니다.aws iotthingsgraph search-things \ --entity-id
"urn:tdm:aws/examples:Device:HCSR501MotionSensor"
출력:
{ "things": [ { "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MotionSensor1", "thingName": "MotionSensor1" }, { "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/TG_MS", "thingName": "TG_MS" } ] }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 모델 생성 및 업로드를 참조하세요.
-
자세한 API 내용은 명령 참조SearchThings
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 tag-resource
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
리소스에 대한 태그를 생성하려면
다음
tag-resource
예제에서는 지정된 리소스에 대한 태그를 생성합니다.aws iotthingsgraph tag-resource \ --resource-arn
"arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218"
\ --tags key="Type",value="Residential"이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 리소스 태그 지정을 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조TagResource
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 undeploy-system-instance
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
대상에서 시스템 인스턴스를 배포 취소하려면
다음
undeploy-system-instance
예제에서는 대상에서 시스템 인스턴스를 제거합니다.aws iotthingsgraph undeploy-system-instance \ --id
"urn:tdm:us-west-2/123456789012/default:Deployment:Room215"
출력:
{ "summary": { "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room215", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room215", "status": "PENDING_DELETE", "target": "GREENGRASS", "greengrassGroupName": "ThingsGraphGrnGr", "createdAt": 1553189694.255, "updatedAt": 1559344549.601, "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", "greengrassGroupVersionId": "731b371d-d644-4b67-ac64-3934e99b75d7" } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 개체, 흐름, 시스템 및 배포의 수명 주기 관리를 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조UndeploySystemInstance
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 untag-resource
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
리소스의 태그를 제거하려면
다음
untag-resource
예제에서는 지정된 리소스에 대한 태그를 제거합니다.aws iotthingsgraph untag-resource \ --resource-arn
"arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218"
\ --tag-keys"Type"
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 IoT 사물 그래프 리소스 태그 지정을 참조하세요. AWS IoT
-
자세한 API 내용은 명령 참조UntagResource
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 update-flow-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
흐름을 업데이트하려면
다음
update-flow-template
예제에서는 흐름(워크플로)을 업데이트합니다. 의 값은 흐름을 모델링하는 GraphQLMyFlowDefinition
입니다.aws iotthingsgraph update-flow-template \ --id
"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow"
\ --definition language=GRAPHQL,text="MyFlowDefinition"출력:
{ "summary": { "createdAt": 1559248067.545, "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", "revisionNumber": 2 } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 흐름 작업을 참조하세요.
-
자세한 API 내용은 명령 참조UpdateFlowTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 update-system-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
시스템을 업데이트하려면
다음
update-system-template
예제에서는 시스템을 업데이트합니다. 의 값은 시스템을 모델링하는 GraphQLMySystemDefinition
입니다.aws iotthingsgraph update-system-template \ --id
"urn:tdm:us-west-2/123456789012/default:System:MySystem"
\ --definition language=GRAPHQL,text="MySystemDefinition"출력:
{ "summary": { "createdAt": 1559249776.254, "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", "revisionNumber": 2 } }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 시스템 생성을 참조하세요.
-
자세한 API 내용은 명령 참조UpdateSystemTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 upload-entity-definitions
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
개체 정의를 업로드하려면
다음
upload-entity-definitions
예제에서는 네임스페이스에 엔터티 정의를 업로드합니다. 의 값은 엔터티를 모델링하는 GraphQLMyEntityDefinitions
입니다.aws iotthingsgraph upload-entity-definitions \ --document language=GRAPHQL,text="MyEntityDefinitions"
출력:
{ "uploadId": "f6294f1e-b109-4bbe-9073-f451a2dda2da" }
자세한 내용은 AWS IoT 사물 그래프 사용 설명서의 모델링 엔터티를 참조하세요.
-
자세한 API 내용은 명령 참조UploadEntityDefinitions
의 섹션을 참조하세요. AWS CLI
-