Dataflow Profile - Create Or Update

Layanan:: IoT Operations

Versi API:: 2026-03-01

Membuat DataflowProfileResource

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperations/instances/{instanceName}/dataflowProfiles/{dataflowProfileName}?api-version=2026-03-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
dataflowProfileName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nama sumber daya Instance dataflowProfile
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nama instans.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
extendedLocation	ExtendedLocation	Lokasi edge sumber daya.
properties	DataflowProfileProperties	Properti khusus sumber daya untuk sumber daya ini.

Respons

Nama	Jenis	Deskripsi
200 OK	DataflowProfileResource	Operasi pembaruan 'DataflowProfileResource' sumber daya berhasil
201 Created	DataflowProfileResource	Resource 'DataflowProfileResource' membuat operasi berhasil Header Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

DataflowProfileResource

Operasi pembaruan 'DataflowProfileResource' sumber daya berhasil

201 Created

DataflowProfileResource

Resource 'DataflowProfileResource' membuat operasi berhasil

Header

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

DataflowProfile_CreateOrUpdate

DataflowProfile_CreateOrUpdate_Minimal

DataflowProfile_CreateOrUpdate_Multi

DataflowProfile_CreateOrUpdate

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/resource-name123?api-version=2026-03-01

{
  "properties": {
    "diagnostics": {
      "logs": {
        "level": "rnmwokumdmebpmfxxxzvvjfdywotav"
      },
      "metrics": {
        "prometheusPort": 7581
      }
    },
    "instanceCount": 14
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  }
}

Respon sampel

Kode status:: 200

{
  "properties": {
    "diagnostics": {
      "logs": {
        "level": "rnmwokumdmebpmfxxxzvvjfdywotav"
      },
      "metrics": {
        "prometheusPort": 7581
      }
    },
    "instanceCount": 14,
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/resource-name123",
  "name": "bwhcjsnnfnrmbixamyxjau",
  "type": "Microsoft.IoTOperations/instances/dataflowProfiles",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

Kode status:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "properties": {
    "diagnostics": {
      "logs": {
        "level": "rnmwokumdmebpmfxxxzvvjfdywotav"
      },
      "metrics": {
        "prometheusPort": 7581
      }
    },
    "instanceCount": 14,
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/resource-name123",
  "name": "bwhcjsnnfnrmbixamyxjau",
  "type": "Microsoft.IoTOperations/instances/dataflowProfiles",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

DataflowProfile_CreateOrUpdate_Minimal

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/aio-dataflowprofile?api-version=2026-03-01

{
  "properties": {
    "instanceCount": 1
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  }
}

Respon sampel

Kode status:: 200

{
  "properties": {
    "instanceCount": 1,
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/resource-name123",
  "name": "bwhcjsnnfnrmbixamyxjau",
  "type": "Microsoft.IoTOperations/instances/dataflowProfiles",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

Kode status:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "properties": {
    "instanceCount": 1,
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/resource-name123",
  "name": "bwhcjsnnfnrmbixamyxjau",
  "type": "Microsoft.IoTOperations/instances/dataflowProfiles",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

DataflowProfile_CreateOrUpdate_Multi

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/aio-dataflowprofile?api-version=2026-03-01

{
  "properties": {
    "instanceCount": 3
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  }
}

Respon sampel

Kode status:: 200

{
  "properties": {
    "instanceCount": 3,
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/resource-name123",
  "name": "bwhcjsnnfnrmbixamyxjau",
  "type": "Microsoft.IoTOperations/instances/dataflowProfiles",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

Kode status:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "properties": {
    "instanceCount": 3,
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123/dataflowProfiles/resource-name123",
  "name": "bwhcjsnnfnrmbixamyxjau",
  "type": "Microsoft.IoTOperations/instances/dataflowProfiles",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
DataflowProfileProperties	Properti Sumber Daya DataflowProfile
DataflowProfileResource	Sumber daya dataflowProfile instans
DataflowProfileStatus	DataflowProfile status.
DiagnosticsLogs	Properti Log Diagnostik
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
ExtendedLocation	Lokasi yang diperluas adalah perpanjangan dari lokasi Azure. Mereka menyediakan cara untuk menggunakan kluster Kubernetes yang mendukung Azure ARC sebagai lokasi target untuk menyebarkan instans layanan Azure.
ExtendedLocationType	Jenis enum yang menentukan ExtendedLocation diterima.
Metrics	Properti Metrik Diagnostik
ProfileDiagnostics	Properti Diagnostik DataflowProfile
ProvisioningState	Status enum yang menentukan sumber daya.
ResourceHealthState	Keadaan kesehatan sumber daya.
ResourceHealthStatus	Mewakili status kesehatan sumber daya.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DataflowProfileProperties

Objek

Properti Sumber Daya DataflowProfile

Nama	Jenis	Nilai default	Deskripsi
diagnostics	ProfileDiagnostics		Spesifikasi mendefinisikan identitas pengaturan diagnostik NBC yang diinginkan.
healthState	ResourceHealthState	Unknown	Keadaan kesehatan sumber daya.
instanceCount	integer (int32) minimum: 1 maximum: 20	1	Untuk menskalakan profil aliran data secara manual, tentukan jumlah maksimum instans yang ingin Anda jalankan.
provisioningState	ProvisioningState		Status operasi terakhir.
status	DataflowProfileStatus		Status untuk profil aliran data.

DataflowProfileResource

Objek

Sumber daya dataflowProfile instans

Nama	Jenis	Deskripsi
extendedLocation	ExtendedLocation	Lokasi edge sumber daya.
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties	DataflowProfileProperties	Properti khusus sumber daya untuk sumber daya ini.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

DataflowProfileStatus

Objek

DataflowProfile status.

Nama	Jenis	Deskripsi
healthState	ResourceHealthStatus	Status kesehatan DataflowProfile.

DiagnosticsLogs

Objek

Properti Log Diagnostik

Nama	Jenis	Nilai default	Deskripsi
level	string	info	Tingkatan log. Contoh - 'debug', 'info', 'warn', 'error', 'trace'.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ExtendedLocation

Objek

Lokasi yang diperluas adalah perpanjangan dari lokasi Azure. Mereka menyediakan cara untuk menggunakan kluster Kubernetes yang mendukung Azure ARC sebagai lokasi target untuk menyebarkan instans layanan Azure.

Nama	Jenis	Deskripsi
name	string	Nama lokasi yang diperluas.
type	ExtendedLocationType	Jenis ExtendedLocation.

ExtendedLocationType

Enumerasi

Jenis enum yang menentukan ExtendedLocation diterima.

Nilai	Deskripsi
CustomLocation	Jenis CustomLocation

Metrics

Objek

Properti Metrik Diagnostik

Nama	Jenis	Nilai default	Deskripsi
prometheusPort	integer (int32) minimum: 0 maximum: 65535	9600	Port prometheus untuk mengekspos metrik.

ProfileDiagnostics

Objek

Properti Diagnostik DataflowProfile

Nama	Jenis	Deskripsi
logs	DiagnosticsLogs	Pengaturan log diagnostik untuk sumber daya.
metrics	Metrics	Pengaturan metrik untuk sumber daya.

ProvisioningState

Enumerasi

Status enum yang menentukan sumber daya.

Nilai	Deskripsi
Succeeded	Sumber daya telah dibuat.
Failed	Pembuatan sumber daya gagal.
Canceled	Pembuatan sumber daya dibatalkan.
Provisioning	Sumber daya sedang disediakan.
Updating	Sumber daya sedang diperbarui.
Deleting	Sumber daya sedang dihapus.
Accepted	Sumber daya telah Diterima.

ResourceHealthState

Enumerasi

Keadaan kesehatan sumber daya.

Nilai	Deskripsi
Available	Sumber daya tersedia dan berfungsi seperti yang diharapkan.
Degraded	Kesehatan sumber daya menurun.
Unavailable	Sumber daya tidak berfungsi seperti yang diharapkan.
Unknown	Status sumber daya tidak diketahui.

ResourceHealthStatus

Objek

Mewakili status kesehatan sumber daya.

Nama	Jenis	Deskripsi
lastTransitionTime	string	Stempel waktu (RFC3339) saat status kesehatan terakhir berubah.
lastUpdateTime	string	Stempel waktu (RFC3339) saat status kesehatan terakhir diperbarui, meskipun statusnya tidak berubah.
message	string	Pesan yang dapat dibaca manusia yang menggambarkan transisi terakhir.
reasonCode	string	Kode alasan CamelCase yang unik yang menjelaskan penyebab transisi status kesehatan terakhir.
status	ResourceHealthState	Status kesehatan tingkat tinggi sumber daya.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

Bagikan melalui

Dataflow Profile - Create Or Update

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

DataflowProfile_CreateOrUpdate

Permintaan sampel

Respon sampel

DataflowProfile_CreateOrUpdate_Minimal

Permintaan sampel

Respon sampel

DataflowProfile_CreateOrUpdate_Multi

Permintaan sampel

Respon sampel

Definisi

createdByType

DataflowProfileProperties

DataflowProfileResource

DataflowProfileStatus

DiagnosticsLogs

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

Metrics

ProfileDiagnostics

ProvisioningState

ResourceHealthState

ResourceHealthStatus

systemData