View a markdown version of this page

AWS IoT Things Graph contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS IoT Things Graph contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface with AWS IoT Things Graph.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanassociate-entity-to-thing.

AWS CLI

Untuk mengaitkan sesuatu dengan perangkat

associate-entity-to-thingContoh berikut mengaitkan sesuatu dengan perangkat. Contoh menggunakan perangkat sensor gerak yang ada di namespace publik.

aws iotthingsgraph associate-entity-to-thing \
    --thing-name "MotionSensorName" \
    --entity-id "urn:tdm:aws/examples:Device:HCSR501MotionSensor"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat dan Mengunggah Model di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakancreate-flow-template.

AWS CLI

Untuk membuat aliran

create-flow-templateContoh berikut membuat aliran (alur kerja). Nilai MyFlowDefinition adalah GraphQL yang memodelkan aliran.

aws iotthingsgraph create-flow-template \
    --definition language=GRAPHQL,text="MyFlowDefinition"

Output:

{
    "summary": {
        "createdAt": 1559248067.545,
        "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow",
        "revisionNumber": 1
    }
}

Untuk informasi selengkapnya, lihat Bekerja dengan Alur di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakancreate-system-instance.

AWS CLI

Untuk membuat instance sistem

create-system-instanceContoh berikut membuat instance sistem. Nilai MySystemInstanceDefinition adalah GraphQL yang memodelkan instance sistem.

aws iotthingsgraph create-system-instance -\
    --definition language=GRAPHQL,text="MySystemInstanceDefinition" \
    --target CLOUD \
    --flow-actions-role-arn myRoleARN

Output:

{
    "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
    }
}

Untuk informasi selengkapnya, lihat Bekerja dengan Konfigurasi Sistem dan Aliran di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakancreate-system-template.

AWS CLI

Untuk membuat sistem

create-system-templateContoh berikut menciptakan sistem. Nilai MySystemDefinition adalah GraphQL yang memodelkan sistem.

aws iotthingsgraph create-system-template \
    --definition language=GRAPHQL,text="MySystemDefinition"

Output:

{
    "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
    }
}

Untuk informasi selengkapnya, lihat Membuat Sistem di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandelete-flow-template.

AWS CLI

Untuk menghapus alur

delete-flow-templateContoh berikut menghapus aliran (alur kerja).

aws iotthingsgraph delete-flow-template \
    --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Manajemen Siklus Hi AWS dup untuk Entitas Grafik, Alur, Sistem, dan Penerapan IoT Things di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandelete-namespace.

AWS CLI

Untuk menghapus namespace

delete-namespaceContoh berikut menghapus namespace.

aws iotthingsgraph delete-namespace

Output:

{
   "namespaceArn": "arn:aws:iotthingsgraph:us-west-2:123456789012",
   "namespaceName": "us-west-2/123456789012/default"
}

Untuk informasi selengkapnya, lihat Manajemen Siklus Hi AWS dup untuk Entitas Grafik, Alur, Sistem, dan Penerapan IoT Things di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandelete-system-instance.

AWS CLI

Untuk menghapus instance sistem

delete-system-instanceContoh berikut menghapus instance sistem.

aws iotthingsgraph delete-system-instance \
    --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Manajemen Siklus Hi AWS dup untuk Entitas Grafik, Alur, Sistem, dan Penerapan IoT Things di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandelete-system-template.

AWS CLI

Untuk menghapus sistem

delete-system-templateContoh berikut menghapus sistem.

aws iotthingsgraph delete-system-template \
    --id "urn:tdm:us-west-2/123456789012/default:System:MySystem"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Manajemen Siklus Hi AWS dup untuk Entitas Grafik, Alur, Sistem, dan Penerapan IoT Things di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandeploy-system-instance.

AWS CLI

Untuk menerapkan instance sistem

delete-system-templateContoh berikut menerapkan instance sistem.

aws iotthingsgraph deploy-system-instance \
    --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218"

Output:

{
   "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
   }
}

Untuk informasi selengkapnya, lihat Bekerja dengan Konfigurasi Sistem dan Aliran di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandeprecate-flow-template.

AWS CLI

Untuk menghentikan aliran

deprecate-flow-templateContoh berikut menghentikan aliran (alur kerja).

aws iotthingsgraph deprecate-flow-template \
    --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Manajemen Siklus Hi AWS dup untuk Entitas Grafik, Alur, Sistem, dan Penerapan IoT Things di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandeprecate-system-template.

AWS CLI

Untuk menghentikan sistem

deprecate-system-templateContoh berikut menghentikan sistem.

aws iotthingsgraph deprecate-system-template \
    --id "urn:tdm:us-west-2/123456789012/default:System:MySystem"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Manajemen Siklus Hi AWS dup untuk Entitas Grafik, Alur, Sistem, dan Penerapan IoT Things di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandescribe-namespace.

AWS CLI

Untuk mendapatkan deskripsi namespace Anda

describe-namespaceContoh berikut mendapatkan deskripsi namespace Anda.

aws iotthingsgraph describe-namespace

Output:

{
    "namespaceName": "us-west-2/123456789012/default",
    "trackingNamespaceName": "aws",
    "trackingNamespaceVersion": 1,
    "namespaceVersion": 5
}

Untuk informasi selengkapnya, lihat Ruang Nama di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakandissociate-entity-from-thing.

AWS CLI

Untuk memisahkan sesuatu dari perangkat

dissociate-entity-from-thingContoh berikut memisahkan sesuatu dari perangkat.

aws iotthingsgraph dissociate-entity-from-thing \
    --thing-name "MotionSensorName" \
    --entity-type "DEVICE"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat dan Mengunggah Model di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanget-entities.

AWS CLI

Untuk mendapatkan definisi untuk entitas

get-entitiesContoh berikut mendapatkan definisi untuk model perangkat.

aws iotthingsgraph get-entities \
    --ids "urn:tdm:aws/examples:DeviceModel:MotionSensor"

Output:

{
    "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}"
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Membuat dan Mengunggah Model di Panduan Pengguna Grafik AWS IoT Things.

  • Untuk detail API, lihat GetEntities di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-flow-template-revisions.

AWS CLI

Untuk mendapatkan informasi revisi tentang alur

get-flow-template-revisionsContoh berikut mendapatkan informasi revisi tentang aliran (alur kerja).

aws iotthingsgraph get-flow-template-revisions \
    --id urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow

Output:

{
    "summaries": [
        {
            "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow",
            "revisionNumber": 1,
            "createdAt": 1559247540.292
        }
    ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Alur di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanget-flow-template.

AWS CLI

Untuk mendapatkan definisi aliran

get-flow-templateContoh berikut mendapatkan definisi untuk aliran (alur kerja).

aws iotthingsgraph get-flow-template \
    --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow"

Output:

{
    "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
    }
}

Untuk informasi selengkapnya, lihat Bekerja dengan Alur di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanget-namespace-deletion-status.

AWS CLI

Untuk mendapatkan status tugas penghapusan namespace

get-namespace-deletion-statusContoh berikut mendapatkan status tugas penghapusan namespace.

aws iotthingsgraph get-namespace-deletion-status

Output:

{
   "namespaceArn": "arn:aws:iotthingsgraph:us-west-2:123456789012",
   "namespaceName": "us-west-2/123456789012/default"
   "status": "SUCCEEDED "
}

Untuk informasi selengkapnya, lihat Ruang Nama di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanget-system-instance.

AWS CLI

Untuk mendapatkan instance sistem

get-system-instanceContoh berikut mendapatkan definisi untuk instance sistem.

aws iotthingsgraph get-system-instance \
    --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218"

Output:

{
    "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"
    }
}

Untuk informasi selengkapnya, lihat Bekerja dengan Konfigurasi Sistem dan Aliran di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanget-system-template-revisions.

AWS CLI

Untuk mendapatkan informasi revisi tentang suatu sistem

get-system-template-revisionsContoh berikut mendapatkan informasi revisi tentang suatu sistem.

aws iotthingsgraph get-system-template-revisions \
    --id "urn:tdm:us-west-2/123456789012/default:System:MySystem"

Output:

{
    "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
        }
    ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Konfigurasi Sistem dan Aliran di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanget-system-template.

AWS CLI

Untuk mendapatkan sistem

get-system-templateContoh berikut mendapatkan definisi untuk suatu sistem.

aws iotthingsgraph get-system-template \
    --id "urn:tdm:us-west-2/123456789012/default:System:MySystem"

Output:

{
    "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
    }
}

Untuk informasi selengkapnya, lihat Bekerja dengan Konfigurasi Sistem dan Aliran di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanget-upload-status.

AWS CLI

Untuk mendapatkan status unggahan entitas Anda

get-upload-statusContoh berikut mendapatkan status operasi upload entitas Anda. Nilai MyUploadId adalah nilai ID yang dikembalikan oleh upload-entity-definitions operasi.

aws iotthingsgraph get-upload-status \
    --upload-id "MyUploadId"

Output:

{
    "namespaceName": "us-west-2/123456789012/default",
    "namespaceVersion": 5,
    "uploadId": "f6294f1e-b109-4bbe-9073-f451a2dda2da",
    "uploadStatus": "SUCCEEDED"
}

Untuk informasi selengkapnya, lihat P emodelan Entitas di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanlist-flow-execution-messages.

AWS CLI

Untuk mendapatkan informasi tentang peristiwa dalam eksekusi alur

list-flow-execution-messagesContoh berikut mendapatkan informasi tentang peristiwa dalam eksekusi aliran.

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"

Output:

{
    "messages": [
        {
         "eventType": "EXECUTION_STARTED",
         "messageId": "f6294f1e-b109-4bbe-9073-f451a2dda2da",
         "payload": "Flow execution started",
         "timestamp": 1559247540.656
        }
    ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Alur di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan semua tag untuk sumber daya

list-tags-for-resourceContoh berikut mencantumkan semua tag untuk sumber daya AWS IoT Things Graph.

aws iotthingsgraph list-tags-for-resource \
    --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218"

Output:

{
   "tags": [
      {
         "key": "Type",
         "value": "Residential"
      }
   ]
}

Untuk informasi selengkapnya, lihat Menandai Sumber AWS Daya Grafik IoT Things Anda di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakansearch-entities.

AWS CLI

Untuk mencari entitas

search-entitiesContoh berikut mencari semua entitas jenisEVENT.

aws iotthingsgraph search-entities \
    --entity-types "EVENT"

Output:

{
    "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"
}

Untuk informasi selengkapnya, lihat Referensi Model Data Grafik AWS IoT AWS Things di Panduan Pengguna Grafik IoT Things.

Contoh kode berikut menunjukkan cara menggunakansearch-flow-executions.

AWS CLI

Untuk mencari eksekusi aliran

search-flow-executionsContoh berikut mencari semua eksekusi aliran dalam instance sistem tertentu.

aws iotthingsgraph search-flow-executions \
    --system-instance-id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218"

Output:

{
   "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
      }
   ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Konfigurasi Sistem dan Aliran di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakansearch-flow-templates.

AWS CLI

Untuk mencari alur (atau alur kerja)

search-flow-templatesContoh berikut mencari semua alur (alur kerja) yang berisi model perangkat Kamera.

aws iotthingsgraph search-flow-templates \
    --filters name="DEVICE_MODEL_ID",value="urn:tdm:aws/examples:DeviceModel:Camera"

Output:

{
    "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
        }
    ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Alur di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakansearch-system-instances.

AWS CLI

Untuk mencari instance sistem

search-system-instancesContoh berikut mencari semua instance sistem yang berisi sistem yang ditentukan.

aws iotthingsgraph search-system-instances \
    --filters name="SYSTEM_TEMPLATE_ID",value="urn:tdm:us-west-2/123456789012/default:System:SecurityFlow"

Output:

{
    "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
        }
    ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Konfigurasi Sistem dan Aliran di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakansearch-system-templates.

AWS CLI

Untuk mencari sistem

search-system-templatesContoh berikut mencari semua sistem yang berisi aliran yang ditentukan.

aws iotthingsgraph search-system-templates \
    --filters name="FLOW_TEMPLATE_ID",value="urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow"

Output:

{
    "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
        }
    ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Alur di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakansearch-things.

AWS CLI

Untuk mencari hal-hal yang terkait dengan perangkat dan model perangkat

search-thingsContoh berikut mencari semua hal yang terkait dengan HCSR501MotionSensor perangkat.

aws iotthingsgraph search-things \
    --entity-id "urn:tdm:aws/examples:Device:HCSR501MotionSensor"

Output:

{
    "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"
        }
    ]
}

Untuk informasi selengkapnya, lihat Membuat dan Mengunggah Model di Panduan Pengguna Grafik AWS IoT Things.

  • Untuk detail API, lihat SearchThings di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk membuat tag untuk sumber daya

tag-resourceContoh berikut membuat tag untuk sumber daya yang ditentukan.

aws iotthingsgraph tag-resource \
    --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218" \
    --tags key="Type",value="Residential"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Sumber AWS Daya Grafik IoT Things Anda di Panduan Pengguna Grafik AWS IoT Things.

  • Untuk detail API, lihat TagResource di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanundeploy-system-instance.

AWS CLI

Untuk membatalkan penerapan instance sistem dari targetnya

undeploy-system-instanceContoh berikut menghapus instance sistem dari targetnya.

aws iotthingsgraph undeploy-system-instance \
    --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room215"

Output:

{
    "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"
    }
}

Untuk informasi selengkapnya, lihat Manajemen Siklus Hi AWS dup untuk Entitas Grafik, Alur, Sistem, dan Penerapan IoT Things di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag untuk sumber daya

untag-resourceContoh berikut menghapus tag untuk sumber daya yang ditentukan.

aws iotthingsgraph untag-resource \
    --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218" \
    --tag-keys "Type"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Sumber AWS Daya Grafik IoT Things Anda di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanupdate-flow-template.

AWS CLI

Untuk memperbarui alur

update-flow-templateContoh berikut memperbarui alur (alur kerja). Nilai MyFlowDefinition adalah GraphQL yang memodelkan aliran.

aws iotthingsgraph update-flow-template \
    --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" \
    --definition language=GRAPHQL,text="MyFlowDefinition"

Output:

{
    "summary": {
        "createdAt": 1559248067.545,
        "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow",
        "revisionNumber": 2
    }
}

Untuk informasi selengkapnya, lihat Bekerja dengan Alur di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanupdate-system-template.

AWS CLI

Untuk memperbarui sistem

update-system-templateContoh berikut memperbarui sistem. Nilai MySystemDefinition adalah GraphQL yang memodelkan sistem.

aws iotthingsgraph update-system-template \
    --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" \
    --definition language=GRAPHQL,text="MySystemDefinition"

Output:

{
    "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
    }
}

Untuk informasi selengkapnya, lihat Membuat Sistem di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanupload-entity-definitions.

AWS CLI

Untuk mengunggah definisi entitas

upload-entity-definitionsContoh berikut mengunggah definisi entitas ke namespace Anda. Nilai MyEntityDefinitions adalah GraphQL yang memodelkan entitas.

aws iotthingsgraph upload-entity-definitions \
    --document language=GRAPHQL,text="MyEntityDefinitions"

Output:

{
    "uploadId": "f6294f1e-b109-4bbe-9073-f451a2dda2da"
}

Untuk informasi selengkapnya, lihat P emodelan Entitas di Panduan Pengguna Grafik AWS IoT Things.