Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tandai AWS IoT SiteWise sumber daya Anda
Menandai AWS IoT SiteWise sumber daya Anda menyediakan cara yang ampuh untuk mengkategorikan, mengelola, dan mengambil aset organisasi secara efisien. Dengan menetapkan tag, yang terdiri dari pasangan nilai kunci, Anda dapat melampirkan metadata deskriptif ke sumber daya Anda. Metadata dari tag dapat digunakan untuk merampingkan operasi. Misalnya, dalam skenario ladang angin, tag memungkinkan Anda memberi label turbin dengan atribut tertentu seperti lokasi, kapasitas, dan status operasional, memungkinkan identifikasi dan manajemen cepat di dalamnya. AWS IoT SiteWise
Mengintegrasikan tag dengan kebijakan AWS Identity and Access Management (IAM) meningkatkan keamanan dan kontrol operasional dengan mendefinisikan aturan akses bersyarat. Ini berarti Anda dapat menentukan bahwa hanya pengguna dengan tag tertentu. Misalnya, hanya mereka yang diberi tag dengan peran atau departemen tertentu, yang dapat mengakses atau memodifikasi sumber daya tertentu.
# Gunakan tag di AWS IoT SiteWise
Gunakan tag untuk mengkategorikan AWS IoT SiteWise sumber daya Anda berdasarkan tujuan, pemilik, lingkungan, atau klasifikasi lainnya untuk kasus penggunaan Anda. Ketika Anda memiliki banyak sumber daya dari jenis yang sama, Anda dapat dengan cepat mengidentifikasi sumber daya tertentu berdasarkan tag-nya.
Setiap tag terdiri dari kunci dan nilai opsional yang Anda tentukan. Misalnya, Anda dapat membuat serangkaian tag untuk model aset Anda untuk melacaknya sesuai dengan proses industri yang mereka dukung. Disarankan untuk mengembangkan satu set kunci tag yang disesuaikan untuk setiap jenis sumber daya yang Anda kelola. Menggunakan satu set kunci tag yang konsisten dapat membuatnya lebih mudah mengelola sumber daya.
## Tag dengan Konsol Manajemen AWS
**Editor Tag** di Konsol Manajemen AWS menyediakan cara terpusat dan terpadu bagi Anda untuk membuat dan mengelola tag Anda untuk sumber daya dari semua AWS layanan. Untuk informasi selengkapnya, lihat [Memulai Editor Tag](https://docs.aws.amazon.com/tag-editor/latest/userguide/gettingstarted.html) di * AWS Sumber Daya Penandaan dan Panduan Pengguna Editor Tag*.
## Tag dengan AWS IoT SiteWise API
AWS IoT SiteWise API juga menggunakan tag. Sebelum Anda membuat tag, perhatikan pembatasan penandaan. Untuk informasi selengkapnya, lihat [Konvensi penamaan dan penggunaan tag](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions) di. *Referensi Umum AWS*
+ Untuk menambahkan tanda selama pembuatan sumber daya, tentukan tag dalam properti `tags` sumber daya.
+ Untuk menambahkan tag ke sumber daya yang ada, atau untuk memperbarui nilai tag, gunakan [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)operasi.
+ Untuk menghapus tag dari sumber daya, gunakan [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)operasi.
+ Untuk mengambil tag yang terkait dengan sumber daya, gunakan [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)operasi, atau jelaskan sumber daya dan periksa propertinya`tags`.
Tabel berikut mencantumkan sumber daya yang dapat Anda beri tag menggunakan AWS IoT SiteWise API `Create` dan terkait serta `Describe` operasinya.
**Sumber daya yang dapat diberi tag AWS IoT SiteWise**
| Sumber daya | Buat operasi | Jelaskan operasi |
| --- | --- | --- |
| Model aset atau model komponen | [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) | [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) |
| Aset | [CreateAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAsset.html) | [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) |
| SiteWise Gerbang tepi | [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) | [DescribeGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeGateway.html) |
| Portal | [CreatePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreatePortal.html) | [DescribePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribePortal.html) |
| Proyek | [CreateProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateProject.html) | [DescribeProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeProject.html) |
| Dasbor | [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html) | [DescribeDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeDashboard.html) |
| Kebijakan akses | [CreateAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAccessPolicy.html) | [DescribeAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAccessPolicy.html) |
| Deret waktu | [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) | [DescribeTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeTimeSeries.html) |
Untuk`[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)`, Anda dapat mengonfigurasi sumber data Anda untuk mengirim data industri AWS IoT SiteWise sebelum Anda membuat model aset dan aset. AWS IoT SiteWise secara otomatis membuat aliran data untuk menerima aliran data mentah dari peralatan Anda. Untuk informasi selengkapnya, lihat [Mengelola konsumsi data](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/data-streams.html).
Gunakan operasi berikut untuk melihat dan mengelola tag untuk sumber daya yang mendukung penandaan:
+ [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)— Menambahkan tag ke sumber daya, atau memperbarui nilai tag yang ada.
+ [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)— Daftar tag untuk sumber daya.
+ [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)— Menghapus tag dari sumber daya.
Tambahkan atau hapus tag dari sumber daya kapan saja. Untuk memperbarui nilai kunci tag yang ada, tambahkan tag baru dengan kunci yang sama dan nilai baru yang Anda inginkan ke sumber daya. Tindakan ini menggantikan nilai lama dengan yang baru. Meskipun dimungkinkan untuk menetapkan string kosong sebagai nilai tag, Anda tidak dapat menetapkan nilai null.
Menghapus sumber daya juga menghapus tag apa pun yang terkait dengannya.
# Gunakan tag dengan kebijakan IAM
Gunakan tag sumber daya dalam kebijakan IAM Anda untuk mengontrol akses dan izin pengguna. Misalnya, kebijakan dapat memungkinkan pengguna untuk hanya membuat sumber daya yang memiliki tag tertentu yang dilampirkan. Kebijakan juga dapat membatasi pengguna untuk membuat atau memodifikasi sumber daya yang memiliki tanda tertentu.
**catatan**
Jika Anda menggunakan tanda untuk mengizinkan atau menolak akses pengguna ke sumber daya, Anda harus menolak memberi pengguna kemampuan untuk menambahkan atau menghapus tanda tersebut untuk sumber daya yang sama. Jika tidak, pengguna dapat melewati batasan Anda dan mendapatkan akses ke sumber daya dengan memodifikasi tag-nya.
Anda dapat menggunakan kunci konteks kondisi berikut dan nilai dalam `Condition` elemen (juga disebut `Condition` blok) dari pernyataan kebijakan.
`aws:ResourceTag/tag-key: tag-value`
Izinkan atau tolak tindakan pada sumber daya dengan tanda tertentu.
`aws:RequestTag/tag-key: tag-value`
Mengharuskan tag tertentu digunakan (atau tidak digunakan) saat membuat atau memodifikasi sumber daya yang dapat diberi tag.
`aws:TagKeys: [tag-key, ...]`
Mengharuskan sekumpulan kunci tag tertentu digunakan (atau tidak digunakan) saat membuat atau memodifikasi sumber daya yang dapat diberi tag.
**catatan**
Kunci dan nilai konteks syarat dalam kebijakan IAM hanya berlaku pada tindakan yang memiliki sumber daya yang dapat ditandai sebagai parameter wajib. Misalnya, Anda dapat mengatur akses bersyarat berbasis tag untuk. [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) Anda tidak dapat menyetel akses bersyarat berbasis tag [PutLoggingOptions](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutLoggingOptions.html)karena tidak ada sumber daya yang dapat diberi tag yang direferensikan dalam permintaan.
Untuk informasi selengkapnya, lihat [Mengontrol akses ke AWS sumber daya menggunakan tag sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) dan [referensi kebijakan IAM JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html) di Panduan Pengguna *IAM*.
**Contoh kebijakan IAM menggunakan tag**
+ [Lihat AWS IoT SiteWise aset berdasarkan tag](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags)