全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::IOT::DeviceGroup

更新时间:Jun 26, 2025

ALIYUN::IOT::DeviceGroup digunakan untuk membuat grup perangkat.

Anda dapat membuat grup di wilayah berikut:
  • Shanghai
  • Singapura (Singapura)
  • Jepang (Tokyo)
  • Jerman (Frankfurt)
  • AS (Silicon Valley)
  • AS (Virginia)

Sintaks

{
  "Type": "ALIYUN::IOT::DeviceGroup",
  "Properties": {
    "SuperGroupId": String,
    "GroupName": String,
    "GroupDesc": String,
    "IotInstanceId": String
  }
}

Properti

Parameter Tipe Diperlukan Dapat Diedit Deskripsi Kendala
SuperGroupId String Tidak Dirilis ID dari grup induk. Untuk membuat grup tingkat -1, jangan tentukan parameter ini. Tidak ada
GroupName String Ya Tidak didukung Nama dari grup perangkat. Nama harus memiliki panjang 4 hingga 30 karakter, dan dapat berisi karakter Cina, huruf besar, huruf kecil, angka, dan garis bawah (_).
Catatan Karakter Cina menempati dua karakter.
GroupDesc String Tidak didukung Didukung Deskripsi dari grup API. Panjangnya tidak boleh melebihi 100 karakter.
Catatan Karakter Cina menempati dua karakter.
IotInstanceId String Tidak Dirilis ID dari instance. Parameter ini tidak diperlukan untuk instance publik.

Nilai pengembalian

Fn::GetAtt

  • GroupId: ID grup, yang merupakan pengenal unik global yang dihasilkan oleh sistem untuk grup tersebut.
  • IotInstanceId: ID dari instance.

Contoh

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Resources": {
    "DeviceGroup": {
      "Type": "ALIYUN::IOT::DeviceGroup",
      "Properties": {
        "IotInstanceId": {
          "Ref": "IotInstanceId"
        },
        "SuperGroupId": {
          "Ref": "SuperGroupId"
        },
        "GroupDesc": {
          "Ref": "GroupDesc"
        },
        "GroupName": {
          "Ref": "GroupName"
        }
      }
    }
  },
  "Parameters": {
    "IotInstanceId": {
      "Type": "String",
      "Description": "Instance publik tidak melewati parameter ini; instance yang Anda butuhkan untuk membeli ID instance masuk."
    },
    "SuperGroupId": {
      "Type": "String",
      "Description": "ID dari grup induk.\nJika Anda ingin membuat grup tingkat pertama, jangan masukkan parameter ini."
    },
    "GroupDesc": {
      "Type": "String",
      "Description": "Deskripsi dari grup. Anda dapat memasukkan deskripsi dengan maksimal 100 karakter."
    },
    "GroupName": {
      "Type": "String",
      "Description": "Nama dari grup. Nama dapat berisi karakter Cina, huruf Inggris, angka, dan garis bawah (_). Panjangnya harus 4 hingga 30 karakter (karakter Cina dihitung sebagai dua karakter)."
    }
  },
  "Outputs": {
    "GroupId": {
      "Description": "Paket, ID, Sistem untuk pengenal unik global yang dihasilkan paket.",
      "Value": {
        "Fn::GetAtt": [
          "DeviceGroup",
          "GroupId"
        ]
      }
    },
    "IotInstanceId": {
      "Description": "ID instance IOT.",
      "Value": {
        "Fn::GetAtt": [
          "DeviceGroup",
          "IotInstanceId"
        ]
      }
    }
  }
}

YAML format

ROSTemplateFormatVersion: '2015-09-01'
Resources:
  DeviceGroup:
    Type: 'ALIYUN::IOT::DeviceGroup'
    Properties:
      IotInstanceId:
        Ref: IotInstanceId
      SuperGroupId:
        Ref: SuperGroupId
      GroupDesc:
        Ref: GroupDesc
      GroupName:
        Ref: GroupName
Parameters:
  IotInstanceId:
    Type: String
    Description: >-
      Instance publik tidak melewati parameter ini; instance yang Anda butuhkan
      untuk membeli ID instance masuk.
  SuperGroupId:
    Type: String
    Description: |-
      ID dari grup induk.
      Jika Anda ingin membuat grup tingkat pertama, jangan masukkan parameter ini.
  GroupDesc:
    Type: String
    Description: >-
      Deskripsi dari grup. Anda dapat memasukkan deskripsi dengan maksimal 100
      karakter.
  GroupName:
    Type: String
    Description: >-
      Nama dari grup. Nama dapat berisi karakter Cina, huruf Inggris, angka, dan
      garis bawah (_). Panjangnya harus 4 hingga 30 karakter (karakter Cina
      dihitung sebagai dua karakter).
Outputs:
  GroupId:
    Description: 'Paket, ID, Sistem untuk pengenal unik global yang dihasilkan paket.'
    Value:
      'Fn::GetAtt':
        -DeviceGroup
        -GroupId
  IotInstanceId:
    Description: ID instance IOT.
    Value:
      'Fn::GetAtt':
        -DeviceGroup
        -IotInstanceId