

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

# Grup benda statis
<a name="thing-groups"></a>

Kelompok benda statis memungkinkan Anda mengelola beberapa hal sekaligus dengan mengkategorikannya ke dalam kelompok. Grup benda statis berisi sekelompok hal yang dikelola dengan menggunakan konsol, CLI, atau API. [Grup benda dinamis](dynamic-thing-groups.md), di sisi lain, berisi hal-hal yang cocok dengan kueri tertentu. Grup benda statis juga dapat berisi grup benda statis lainnya - Anda dapat membangun hierarki grup. Anda dapat melampirkan kebijakan ke grup induk dan itu diwarisi oleh grup turunannya, dan oleh semua hal dalam grup dan di grup anaknya. Ini membuat kontrol izin mudah untuk sejumlah besar hal.

**catatan**  
Kebijakan grup hal tidak mengizinkan akses ke operasi pesawat AWS IoT Greengrass data. Untuk mengizinkan akses sesuatu ke operasi pesawat AWS IoT Greengrass data, tambahkan izin ke AWS IoT kebijakan yang Anda lampirkan ke sertifikat benda tersebut. Untuk informasi selengkapnya, lihat [Otentikasi dan otorisasi perangkat](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-auth#iot-policies.html) di panduan *AWS IoT Greengrass pengembang*.

Berikut adalah hal-hal yang dapat Anda lakukan dengan grup benda statis:
+ Buat, jelaskan, atau hapus grup.
+ Tambahkan sesuatu ke grup, atau ke lebih dari satu grup.
+ Hapus sesuatu dari grup.
+ Buat daftar grup yang telah Anda buat.
+ Buat daftar semua kelompok anak dari suatu kelompok (keturunan langsung dan tidak langsungnya.)
+ Buat daftar hal-hal dalam kelompok, termasuk semua hal dalam kelompok anaknya.
+ Buat daftar semua kelompok leluhur dari suatu kelompok (orang tua langsung dan tidak langsungnya.)
+ Tambahkan, hapus, atau perbarui atribut grup. (Atribut adalah pasangan nama-nilai yang dapat Anda gunakan untuk menyimpan informasi tentang grup.)
+ Lampirkan atau lepaskan kebijakan ke atau dari grup.
+ Buat daftar kebijakan yang dilampirkan ke grup.
+ Buat daftar kebijakan yang diwarisi oleh suatu hal (berdasarkan kebijakan yang dilampirkan pada grupnya, atau salah satu kelompok induknya.)
+ Konfigurasikan opsi logging untuk hal-hal dalam grup. Lihat [Konfigurasikan AWS IoT logging](configure-logging.md). 
+ Buat pekerjaan yang dikirim ke dan dieksekusi pada setiap hal dalam kelompok dan kelompok anaknya. Lihat [AWS IoT Lowongan](iot-jobs.md).

**catatan**  
Ketika sesuatu dilampirkan ke grup benda statis tempat AWS IoT Core kebijakan dilampirkan, nama benda harus cocok dengan ID klien.

Berikut adalah beberapa batasan kelompok benda statis:
+ Sebuah kelompok dapat memiliki paling banyak satu orang tua langsung.
+ Jika grup adalah anak dari grup lain, tentukan ini pada saat itu dibuat.
+ Anda tidak dapat mengubah induk grup nanti, jadi pastikan untuk merencanakan hierarki grup Anda dan membuat grup induk sebelum Anda membuat grup anak yang dikandungnya.
+ 

  Jumlah kelompok yang dapat dimiliki suatu benda [terbatas](https://docs.aws.amazon.com//general/latest/gr/iot_device_management.html#thing-limits).
+ Anda tidak dapat menambahkan sesuatu ke lebih dari satu grup dalam hierarki yang sama. (Dengan kata lain, Anda tidak dapat menambahkan apa pun ke dua grup yang memiliki induk yang sama.)
+ Anda tidak dapat mengganti nama grup.
+ Nama grup benda tidak dapat berisi karakter internasional, seperti û, é dan ñ.
+ Jangan gunakan informasi yang dapat diidentifikasi secara pribadi dalam nama grup barang Anda. Nama grup benda dapat muncul dalam komunikasi dan laporan yang tidak terenkripsi. 

Melampirkan dan melepaskan kebijakan ke grup dapat meningkatkan keamanan AWS IoT operasi Anda dalam beberapa cara yang signifikan. Metode per-perangkat untuk melampirkan kebijakan ke sertifikat, yang kemudian dilampirkan pada suatu hal, memakan waktu dan menyulitkan untuk memperbarui atau mengubah kebijakan dengan cepat di seluruh armada perangkat. Memiliki kebijakan yang dilampirkan pada grup benda menyimpan langkah-langkah ketika tiba saatnya untuk memutar sertifikat pada suatu hal. Dan kebijakan diterapkan secara dinamis pada berbagai hal ketika mereka mengubah keanggotaan grup, sehingga Anda tidak diharuskan untuk membuat ulang kumpulan izin yang rumit setiap kali perangkat mengubah keanggotaan dalam grup.

## Buat grup benda statis
<a name="create-thing-group"></a>

Gunakan **CreateThingGroup** perintah untuk membuat grup benda statis:

```
$ aws iot create-thing-group --thing-group-name LightBulbs
```

**CreateThingGroup**Perintah mengembalikan respon yang berisi nama grup benda statis, ID, dan ARN:

```
{
    "thingGroupName": "LightBulbs", 
    "thingGroupId": "abcdefgh12345678ijklmnop12345678qrstuvwx",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
}
```

**catatan**  
Kami tidak menyarankan untuk menggunakan informasi identitas pribadi dalam nama grup barang Anda.

Berikut adalah contoh yang menentukan induk dari kelompok hal statis ketika dibuat:

```
$ aws iot create-thing-group --thing-group-name RedLights --parent-group-name LightBulbs
```

Seperti sebelumnya, **CreateThingGroup** perintah mengembalikan respons yang berisi nama grup benda statis, ID, dan ARN:

```
{
    "thingGroupName": "RedLights", 
    "thingGroupId": "abcdefgh12345678ijklmnop12345678qrstuvwx",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLights",
}
```

**penting**  
Ingatlah batas-batas berikut saat membuat hierarki grup benda:  
Kelompok benda hanya dapat memiliki satu orang tua langsung.
Jumlah kelompok anak langsung yang dapat dimiliki oleh suatu kelompok [terbatas](https://docs.aws.amazon.com//general/latest/gr/iot_device_management.html#thing-group-limits).
Kedalaman maksimum hierarki grup [terbatas](https://docs.aws.amazon.com//general/latest/gr/iot_device_management.html#thing-group-limits).
Jumlah atribut yang dapat dimiliki suatu kelompok [terbatas](https://docs.aws.amazon.com//general/latest/gr/iot_device_management.html#thing-group-limits). (Atribut adalah pasangan nama-nilai yang dapat Anda gunakan untuk menyimpan informasi tentang grup.) Panjang setiap nama atribut dan setiap nilai juga [terbatas](https://docs.aws.amazon.com//general/latest/gr/iot_device_management.html#thing-group-limits).

## Jelaskan kelompok hal
<a name="describe-thing-group"></a>

Anda dapat menggunakan **DescribeThingGroup** perintah untuk mendapatkan informasi tentang grup hal:

```
$ aws iot describe-thing-group --thing-group-name RedLights
```

**DescribeThingGroup**Perintah mengembalikan informasi tentang grup yang ditentukan:

```
{
    "thingGroupName": "RedLights", 
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLights",
    "thingGroupId": "12345678abcdefgh12345678ijklmnop12345678",
    "version": 1,
    "thingGroupMetadata": {
        "creationDate": 1478299948.882
        "parentGroupName": "Lights",
        "rootToParentThingGroups": [
            {
                "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/ShinyObjects",
                "groupName": "ShinyObjects"
            },
            {
                "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs",
                "groupName": "LightBulbs"
            }
        ]
    },
    "thingGroupProperties": {
        "attributePayload": {
            "attributes": {
                "brightness": "3400_lumens"
            },
        },
        "thingGroupDescription": "string"
    },
}
```

## Tambahkan sesuatu ke grup benda statis
<a name="add-thing-to-group"></a>

Anda dapat menggunakan **AddThingToThingGroup** perintah untuk menambahkan sesuatu ke grup benda statis:

```
$ aws iot add-thing-to-thing-group --thing-name MyLightBulb --thing-group-name RedLights
```

**AddThingToThingGroup**Perintah tidak menghasilkan output apa pun.

**penting**  
Anda dapat menambahkan sesuatu ke maksimal 10 grup. Tetapi Anda tidak dapat menambahkan sesuatu ke lebih dari satu grup dalam hierarki yang sama. (Dengan kata lain, Anda tidak dapat menambahkan sesuatu ke dua grup yang berbagi induk yang sama.)  
Jika sesuatu milik sebanyak mungkin grup benda, dan satu atau lebih grup tersebut adalah grup benda dinamis, Anda dapat menggunakan [https://docs.aws.amazon.com/iot/latest/apireference/API_AddThingToThingGroup.html#iot-AddThingToThingGroup-request-overrideDynamicGroups](https://docs.aws.amazon.com/iot/latest/apireference/API_AddThingToThingGroup.html#iot-AddThingToThingGroup-request-overrideDynamicGroups)bendera untuk membuat grup statis diprioritaskan daripada grup dinamis.

## Hapus sesuatu dari grup benda statis
<a name="remove-thing-from-group"></a>

Anda dapat menggunakan **RemoveThingFromThingGroup** perintah untuk menghapus sesuatu dari grup:

```
$ aws iot remove-thing-from-thing-group --thing-name MyLightBulb --thing-group-name RedLights
```

**RemoveThingFromThingGroup**Perintah tidak menghasilkan output apa pun.

## Daftar hal-hal dalam kelompok hal
<a name="list-things-in-thing-group"></a>

Anda dapat menggunakan **ListThingsInThingGroup** perintah untuk membuat daftar hal-hal yang termasuk dalam grup:

```
$ aws iot list-things-in-thing-group --thing-group-name LightBulbs
```

**ListThingsInThingGroup**Perintah mengembalikan daftar hal-hal dalam kelompok yang diberikan:

```
{
    "things":[
        "TestThingA"
    ]
}
```

Dengan `--recursive` parameter, Anda dapat membuat daftar hal-hal milik grup dan yang ada di salah satu grup turunannya:

```
$ aws iot list-things-in-thing-group --thing-group-name LightBulbs --recursive
```

```
{
    "things":[
        "TestThingA",
        "MyLightBulb"
    ]
}
```

**catatan**  
Operasi ini [pada akhirnya konsisten](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). Dengan kata lain, perubahan pada kelompok benda mungkin tidak tercermin sekaligus.

## Daftar kelompok hal
<a name="list-thing-groups"></a>

Anda dapat menggunakan **ListThingGroups** perintah untuk membuat daftar grup hal akun Anda:

```
$ aws iot list-thing-groups
```

**ListThingGroups**Perintah mengembalikan daftar grup hal di Akun AWS:

```
{
    "thingGroups": [
        {
            "groupName": "LightBulbs", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
        },
        {
            "groupName": "RedLights", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLights"
        },
        {
            "groupName": "RedLEDLights", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLEDLights"
        },
        {
            "groupName": "RedIncandescentLights", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedIncandescentLights"
        }
        {
            "groupName": "ReplaceableObjects", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/ReplaceableObjects"
        }
    ]
}
```

Gunakan filter opsional untuk mencantumkan grup yang memiliki grup tertentu sebagai parent (`--parent-group`) atau grup yang namanya dimulai dengan awalan (`--name-prefix-filter`.) `--recursive`Parameter ini memungkinkan Anda untuk membuat daftar semua grup anak, bukan hanya grup anak langsung dari grup hal:

```
$ aws iot list-thing-groups --parent-group LightBulbs
```

Dalam hal ini, **ListThingGroups** perintah mengembalikan daftar grup anak langsung dari grup hal yang didefinisikan dalam Akun AWS:

```
{
    "childGroups":[
        {
            "groupName": "RedLights", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLights"
        }
    ]
}
```

Gunakan `--recursive` parameter dengan **ListThingGroups** perintah untuk mencantumkan semua grup anak dari grup benda, bukan hanya mengarahkan anak-anak:

```
$ aws iot list-thing-groups --parent-group LightBulbs --recursive
```

**ListThingGroups**Perintah mengembalikan daftar semua kelompok anak dari grup hal:

```
{
    "childGroups":[
        {
            "groupName": "RedLights", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLights"
        },
        {
            "groupName": "RedLEDLights", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLEDLights"
        },
        {
            "groupName": "RedIncandescentLights", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedIncandescentLights"
        }
    ]
}
```

**catatan**  
Operasi ini [pada akhirnya konsisten](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). Dengan kata lain, perubahan pada kelompok benda mungkin tidak tercermin sekaligus.

## Daftar grup untuk suatu hal
<a name="list-thing-groups-for-thing"></a>

Anda dapat menggunakan **ListThingGroupsForThing** perintah untuk membuat daftar grup langsung yang dimiliki suatu benda:

```
$ aws iot list-thing-groups-for-thing --thing-name MyLightBulb
```

**ListThingGroupsForThing**Perintah mengembalikan daftar grup hal langsung yang menjadi milik benda ini:

```
{
    "thingGroups":[
        {
            "groupName": "LightBulbs", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
        },
        {
            "groupName": "RedLights", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLights"
        },
        {
            "groupName": "ReplaceableObjects", 
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/ReplaceableObjects"
        }
    ]
}
```

Anda juga dapat mengakses API ini dalam mesin aturan menggunakan fungsi `get_registry_data()` inline. Anda dapat menggunakan fungsi ini untuk secara dinamis mengakses dan memanfaatkan informasi registri benda (termasuk atribut, tipe benda, dan keanggotaan grup) dengan memanggil `DescribeThing` dan `ListThingGroupsForThing` APIs langsung dalam AWS IoT aturan, memungkinkan pemrosesan dan perutean pesan real-time berdasarkan data registri perangkat Anda. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-registry_data](https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-registry_data).

## Perbarui grup benda statis
<a name="update-thing-group"></a>

Anda dapat menggunakan **UpdateThingGroup** perintah untuk memperbarui atribut grup benda statis:

```
$ aws iot update-thing-group --thing-group-name "LightBulbs" --thing-group-properties "thingGroupDescription=\"this is a test group\", attributePayload=\"{\"attributes\"={\"Owner\"=\"150\",\"modelNames\"=\"456\"}}"
```

**UpdateThingGroup**Perintah mengembalikan respons yang berisi nomor versi grup setelah pembaruan:

```
{
    "version": 4
}
```

**catatan**  
Jumlah atribut yang dapat dimiliki suatu benda [terbatas](https://docs.aws.amazon.com//general/latest/gr/iot_device_management.html#thing-limits).  


## Hapus grup benda
<a name="delete-thing-group"></a>

Untuk menghapus grup sesuatu, gunakan **DeleteThingGroup** perintah:

```
$ aws iot delete-thing-group --thing-group-name "RedLights"
```

**DeleteThingGroup**Perintah tidak menghasilkan output apa pun.

**penting**  
Jika Anda mencoba menghapus grup benda yang memiliki grup hal anak, Anda menerima kesalahan:   

```
A client error (InvalidRequestException) occurred when calling the DeleteThingGroup 
operation: Cannot delete thing group : RedLights when there are still child groups attached to it.
```
Sebelum Anda menghapus grup, hapus grup anak apa pun terlebih dahulu.

Anda dapat menghapus grup yang memiliki item turunan, tetapi izin apa pun yang diberikan untuk hal-hal tersebut oleh keanggotaan dalam grup tidak lagi berlaku. Sebelum menghapus grup yang memiliki kebijakan terlampir, periksa dengan seksama bahwa menghapus izin tersebut tidak akan menghentikan hal-hal dalam grup agar tidak dapat berfungsi dengan baik. Selain itu, perintah yang menunjukkan grup mana yang dimiliki (misalnya,**ListGroupsForThing**) mungkin terus menampilkan grup saat catatan di cloud sedang diperbarui.

## Lampirkan kebijakan ke grup benda statis
<a name="group-attach-policy"></a>

Anda dapat menggunakan **AttachPolicy** perintah untuk melampirkan kebijakan ke grup benda statis dan karenanya, dengan ekstensi, ke semua hal dalam grup itu dan hal-hal di salah satu grup turunannya:

```
$ aws iot attach-policy \
  --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
  --policy-name "myLightBulbPolicy"
```

**AttachPolicy**Perintah tidak menghasilkan output apa pun

**penting**  
Anda dapat melampirkan jumlah maksimum dua kebijakan ke grup.

**catatan**  
Kami tidak menyarankan menggunakan informasi identitas pribadi dalam nama kebijakan Anda.

`--target`Parameternya bisa berupa grup ARN (seperti di atas), sertifikat ARN, atau Identitas Amazon Cognito. Untuk informasi selengkapnya tentang kebijakan, sertifikat, dan otentikasi, lihat[Autentikasi](authentication.md).

Untuk informasi selengkapnya, lihat [AWS IoT Core kebijakan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html).

## Lepaskan kebijakan dari grup benda statis
<a name="group-detach-policy"></a>

Anda dapat menggunakan **DetachPolicy** perintah untuk melepaskan kebijakan dari grup dan dengan demikian, dengan ekstensi, ke semua hal dalam grup itu dan hal-hal di salah satu grup turunannya:

```
$ aws iot detach-policy --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" --policy-name "myLightBulbPolicy"
```

**DetachPolicy**Perintah tidak menghasilkan output apa pun.

## Buat daftar kebijakan yang dilampirkan ke grup benda statis
<a name="group-list-policies"></a>

Anda dapat menggunakan **ListAttachedPolicies** perintah untuk membuat daftar kebijakan yang dilampirkan ke grup hal statis:

```
$ aws iot list-attached-policies --target "arn:aws:iot:us-west-2:123456789012:thinggroup/RedLights"
```

`--target`Parameternya bisa berupa ARN grup benda (seperti di atas), sertifikat ARN, atau identitas Amazon Cognito.

Tambahkan `--recursive` parameter opsional untuk menyertakan semua kebijakan yang dilampirkan ke grup induk grup.

**ListAttachedPolicies**Perintah mengembalikan daftar kebijakan:

```
{
    "policies": [
        "MyLightBulbPolicy" 
        ...
    ]
}
```

## Buat daftar grup untuk kebijakan
<a name="group-list-targets-for-policy"></a>

Anda dapat menggunakan **ListTargetsForPolicy** perintah untuk mencantumkan target, termasuk grup apa pun, yang dilampirkan kebijakan:

```
$ aws iot list-targets-for-policy --policy-name "MyLightBulbPolicy"
```

Tambahkan `--page-size number` parameter opsional untuk menentukan jumlah maksimum hasil yang akan dikembalikan untuk setiap kueri, dan `--marker string` parameter pada panggilan berikutnya untuk mengambil set hasil berikutnya, jika ada.

**ListTargetsForPolicy**Perintah mengembalikan daftar target dan token yang akan digunakan untuk mengambil lebih banyak hasil:

```
{
    "nextMarker": "string",
    "targets": [ "string" ... ]
}
```

## Dapatkan kebijakan yang efektif untuk suatu hal
<a name="group-get-effective-policies"></a>

Anda dapat menggunakan **GetEffectivePolicies** perintah untuk membuat daftar kebijakan yang berlaku untuk suatu hal, termasuk kebijakan yang dilampirkan ke grup mana pun yang menjadi miliknya (apakah grup tersebut adalah induk langsung atau leluhur tidak langsung):

```
$ aws iot get-effective-policies \
  --thing-name "MyLightBulb" \
  --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
```

Gunakan `--principal` parameter untuk menentukan ARN dari sertifikat yang dilampirkan pada benda itu. Jika Anda menggunakan otentikasi identitas Amazon Cognito, gunakan `--cognito-identity-pool-id` parameter dan, secara opsional, tambahkan `--principal` parameter untuk menentukan identitas Amazon Cognito. Jika Anda hanya menentukan`--cognito-identity-pool-id`, kebijakan yang terkait dengan peran kumpulan identitas tersebut untuk pengguna yang tidak diautentikasi akan dikembalikan. Jika Anda menggunakan keduanya, kebijakan yang terkait dengan peran kumpulan identitas tersebut untuk pengguna yang diautentikasi akan dikembalikan.

`--thing-name`Parameternya opsional dan dapat digunakan sebagai pengganti `--principal` parameter. Saat digunakan, kebijakan yang dilampirkan ke grup mana pun yang menjadi miliknya, dan kebijakan yang dilampirkan ke grup induk mana pun dari grup ini (hingga grup root dalam hierarki) dikembalikan.

**GetEffectivePolicies**Perintah mengembalikan daftar kebijakan:

```
{
    "effectivePolicies": [
        {
            "policyArn": "string",
            "policyDocument": "string",
            "policyName": "string"
        }
        ...
    ]
}
```

## Otorisasi uji untuk tindakan MQTT
<a name="group-test-authorization"></a>

Anda dapat menggunakan **TestAuthorization** perintah untuk menguji apakah tindakan [MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html) (`Publish`,`Subscribe`) diizinkan untuk suatu hal:

```
aws iot test-authorization \
    --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847" \
    --auth-infos "{\"actionType\": \"PUBLISH\", \"resources\": [ \"arn:aws:iot:us-east-1:123456789012:topic/my/topic\"]}"
```

Gunakan `--principal` parameter untuk menentukan ARN dari sertifikat yang dilampirkan pada benda itu. Jika menggunakan autentikasi Identitas Amazon Cognito, tentukan Identitas Cognito sebagai `--principal` atau gunakan parameter, atau keduanya. `--cognito-identity-pool-id` (Jika Anda hanya menentukan kebijakan yang `--cognito-identity-pool-id` terkait dengan peran kumpulan identitas tersebut untuk pengguna yang tidak diautentikasi akan dipertimbangkan. Jika Anda menggunakan keduanya, kebijakan yang terkait dengan peran kumpulan identitas tersebut untuk pengguna yang diautentikasi akan dipertimbangkan.

Tentukan satu atau beberapa tindakan MQTT yang ingin Anda uji dengan mencantumkan kumpulan sumber daya dan jenis tindakan yang mengikuti parameter. `--auth-infos` `actionType`Bidang harus berisi “PUBLISH”, “SUBSCRIBE”, “RECEIVE”, atau “CONNECT”. `resources`Bidang harus berisi daftar sumber daya ARNs. Untuk informasi selengkapnya, lihat [AWS IoT Core kebijakan](iot-policies.md).

Anda dapat menguji efek penambahan kebijakan dengan menentukannya dengan `--policy-names-to-add` parameter. Atau Anda dapat menguji efek penghapusan kebijakan oleh mereka dengan `--policy-names-to-skip` parameter.

Anda dapat menggunakan `--client-id` parameter opsional untuk lebih menyempurnakan hasil Anda.

**TestAuthorization**Perintah mengembalikan detail tentang tindakan yang diizinkan atau ditolak untuk setiap kumpulan `--auth-infos` kueri yang Anda tentukan:

```
{
    "authResults": [
        {
            "allowed": {
                "policies": [
                    {
                        "policyArn": "string",
                        "policyName": "string"
                    }
                ]
            },
            "authDecision": "string",
            "authInfo": {
                "actionType": "string",
                "resources": [ "string" ]
            },
            "denied": {
                "explicitDeny": {
                    "policies": [
                        {
                            "policyArn": "string",
                            "policyName": "string"
                        }
                    ]
                },
                "implicitDeny": {
                    "policies": [
                        {
                            "policyArn": "string",
                            "policyName": "string"
                        }
                    ]
                }
            },
            "missingContextValues": [ "string" ]
        }
    ]
}
```