AWS IoT Things Graph contoh menggunakan AWS CLI - AWS Contoh Kode SDK
Tindakan

Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh SDK AWS Doc. GitHub

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 mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with AWS IoT Things Graph.

Tindakan adalah 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 menciptakan alur (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 Sistem dan Konfigurasi 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 aliran

delete-flow-templateContoh berikut menghapus alur (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 Hidup untuk Entitas, Aliran, Sistem, dan Penerapan Grafik AWS IoT Things di Panduan Pengguna Grafik IoT Things.AWS

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 Hidup untuk Entitas, Aliran, Sistem, dan Penerapan Grafik AWS IoT Things di Panduan Pengguna Grafik IoT Things.AWS

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 Hidup untuk Entitas, Aliran, Sistem, dan Penerapan Grafik AWS IoT Things di Panduan Pengguna Grafik IoT Things.AWS

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 Hidup untuk Entitas, Aliran, Sistem, dan Penerapan Grafik AWS IoT Things di Panduan Pengguna Grafik IoT Things.AWS

Contoh kode berikut menunjukkan cara menggunakandeploy-system-instance.

AWS CLI

Untuk menyebarkan instance sistem

delete-system-templateContoh berikut menyebarkan 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 Sistem dan Konfigurasi 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 alur (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 Hidup untuk Entitas, Aliran, Sistem, dan Penerapan Grafik AWS IoT Things di Panduan Pengguna Grafik IoT Things.AWS

Contoh kode berikut menunjukkan cara menggunakandeprecate-system-template.

AWS CLI

Untuk menghentikan sistem

deprecate-system-templateContoh berikut mencela 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 Hidup untuk Entitas, Aliran, Sistem, dan Penerapan Grafik AWS IoT Things di Panduan Pengguna Grafik IoT Things.AWS

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 GetEntitiesdi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk mendapatkan informasi revisi tentang aliran

get-flow-template-revisionsContoh berikut mendapatkan informasi revisi tentang alur (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 mendapat definisi untuk alur (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 mendapat 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 Sistem dan Konfigurasi 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 mendapat 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 Sistem dan Konfigurasi 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 mendapat 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 Sistem dan Konfigurasi Aliran di Panduan Pengguna Grafik AWS IoT Things.

Contoh kode berikut menunjukkan cara menggunakanget-upload-status.

AWS CLI

Untuk mendapatkan status upload 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 Entitas Pemodelan 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 aliran

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 Grafik AWS IoT Things.

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 Daya Grafik AWS IoT Things Anda di Panduan Pengguna AWS Grafik IoT Things.

Contoh kode berikut menunjukkan cara menggunakansearch-entities.

AWS CLI

Untuk mencari entitas

search-entitiesContoh berikut mencari semua entitas tipeEVENT.

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 Things di Panduan AWS Pengguna Grafik IoT Things.

  • Untuk detail API, lihat SearchEntitiesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakansearch-flow-executions.

AWS CLI

Untuk mencari eksekusi aliran

search-flow-executionsContoh berikut mencari semua eksekusi aliran dalam contoh 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 Sistem dan Konfigurasi 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 Sistem dan Konfigurasi 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 MotionSensor perangkat HCSR5 01.

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 SearchThingsdi Referensi AWS CLI 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 Daya Grafik AWS IoT Things Anda di Panduan Pengguna AWS Grafik IoT Things.

  • Untuk detail API, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanundeploy-system-instance.

AWS CLI

Untuk menghapus instans 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 Hidup untuk Entitas, Aliran, Sistem, dan Penerapan Grafik AWS IoT Things di Panduan Pengguna Grafik IoT Things.AWS

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 Daya Grafik AWS IoT Things Anda di Panduan Pengguna AWS Grafik IoT Things.

  • Untuk detail API, lihat UntagResourcedi Referensi AWS CLI Perintah.

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 Entitas Pemodelan di Panduan Pengguna Grafik AWS IoT Things.