Dataflow Profile - Create Or Update

DataflowProfileResource oluşturma

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

URI Parametreleri

Name İçinde Gerekli Tür Description
dataflowProfileName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$

Örnek veri akışıProfil kaynağının adı

instanceName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$

Örneğin adı.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.

subscriptionId
path True

string (uuid)

Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name Tür Description
extendedLocation

ExtendedLocation

Kaynağın kenar konumu.

properties

DataflowProfileProperties

Bu kaynağın kaynağa özgü özellikleri.

Yanıtlar

Name Tür Description
200 OK

DataflowProfileResource

Kaynak 'DataflowProfileResource' güncelleştirme işlemi başarılı oldu

201 Created

DataflowProfileResource

Kaynak 'DataflowProfileResource' oluşturma işlemi başarılı oldu

Üst Bilgiler

  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation kullanıcı hesabınızı taklit etme

Örnekler

DataflowProfile_CreateOrUpdate
DataflowProfile_CreateOrUpdate_Minimal
DataflowProfile_CreateOrUpdate_Multi

DataflowProfile_CreateOrUpdate

Örnek isteği

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-07-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"
  }
}

Örnek yanıt

{
  "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"
  }
}
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

Örnek isteği

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-07-01

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

Örnek yanıt

{
  "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"
  }
}
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

Örnek isteği

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-07-01

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

Örnek yanıt

{
  "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"
  }
}
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"
  }
}

Tanımlar

Name Description
createdByType

Kaynağı oluşturan kimliğin türü.

DataflowProfileProperties

DataflowProfile Kaynak özellikleri

DataflowProfileResource

Örnek veri akışıProfil kaynağı

DataflowProfileStatus

DataflowProfile durumu.

DiagnosticsLogs

Tanılama Günlüğü özellikleri

ErrorAdditionalInfo

Kaynak yönetimi hatasına ilişkin ek bilgiler.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

ExtendedLocation

Genişletilmiş konum, Azure konumlarının bir uzantısıdır. Azure ARC özellikli Kubernetes kümelerini Azure hizmet örneklerini dağıtmak için hedef konumlar olarak kullanmak için bir yol sağlar.

ExtendedLocationType

ExtendedLocation türünü tanımlayan sabit listesi kabul edildi.

Metrics

Tanılama Ölçümleri özellikleri

ProfileDiagnostics

DataflowProfile Tanılama özellikleri

ProvisioningState

Kaynağın durumunu tanımlayan sabit listesi.

ResourceHealthState

Kaynağın sistem durumu.

ResourceHealthStatus

Bir kaynağın sağlık durumunu temsil eder.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

createdByType

Kaynağı oluşturan kimliğin türü.

Değer Description
User
Application
ManagedIdentity
Key

DataflowProfileProperties

DataflowProfile Kaynak özellikleri

Name Tür Default value Description
diagnostics

ProfileDiagnostics

Belirtim, NBC tanılama ayarlarının istenen kimliklerini tanımlar.

healthState

ResourceHealthState

Unknown

Kaynağın sistem durumu.

instanceCount

integer (int32)

minimum: 1
maximum: 20
1

Veri akışı profilini el ile ölçeklendirmek için çalıştırmak istediğiniz en fazla örnek sayısını belirtin.

provisioningState

ProvisioningState

Son işlemin durumu.

status

DataflowProfileStatus

Veri akışı profilinin durumu.

DataflowProfileResource

Örnek veri akışıProfil kaynağı

Name Tür Description
extendedLocation

ExtendedLocation

Kaynağın kenar konumu.

id

string (arm-id)

Kaynağın tam nitelikli kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Kaynağın adı

properties

DataflowProfileProperties

Bu kaynağın kaynağa özgü özellikleri.

systemData

systemData

createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.

type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

DataflowProfileStatus

DataflowProfile durumu.

Name Tür Description
healthState

ResourceHealthStatus

DataflowProfile'in sağlık durumu.

DiagnosticsLogs

Tanılama Günlüğü özellikleri

Name Tür Default value Description
level

string

info

Log seviyesi. Örnekler : 'debug', 'info', 'warn', 'error', 'trace'.

ErrorAdditionalInfo

Kaynak yönetimi hatasına ilişkin ek bilgiler.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgisi.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

ExtendedLocation

Genişletilmiş konum, Azure konumlarının bir uzantısıdır. Azure ARC özellikli Kubernetes kümelerini Azure hizmet örneklerini dağıtmak için hedef konumlar olarak kullanmak için bir yol sağlar.

Name Tür Description
name

string

Genişletilmiş konumun adı.

type

ExtendedLocationType

ExtendedLocation türü.

ExtendedLocationType

ExtendedLocation türünü tanımlayan sabit listesi kabul edildi.

Değer Description
CustomLocation

CustomLocation türü

Metrics

Tanılama Ölçümleri özellikleri

Name Tür Default value Description
prometheusPort

integer (int32)

minimum: 0
maximum: 65535
9600

Ölçümleri kullanıma sunan prometheus bağlantı noktası.

ProfileDiagnostics

DataflowProfile Tanılama özellikleri

Name Tür Description
logs

DiagnosticsLogs

Kaynak için tanılama günlüğü ayarları.

metrics

Metrics

Kaynağın ölçüm ayarları.

ProvisioningState

Kaynağın durumunu tanımlayan sabit listesi.

Değer Description
Succeeded

Kaynak oluşturuldu.

Failed

Kaynak oluşturma başarısız oldu.

Canceled

Kaynak oluşturma işlemi iptal edildi.

Provisioning

Kaynak sağlanıyor.

Updating

Kaynak Güncelleniyor.

Deleting

Kaynak Siliniyor.

Accepted

Kaynak Kabul Edildi.

ResourceHealthState

Kaynağın sistem durumu.

Değer Description
Available

Kaynak Kullanılabilir ve beklendiği gibi çalışıyor.

Degraded

Kaynak sağlığı bozulur.

Unavailable

Kaynak beklendiği gibi çalışmıyor.

Unknown

Kaynak durumu bilinmiyor.

ResourceHealthStatus

Bir kaynağın sağlık durumunu temsil eder.

Name Tür Description
lastTransitionTime

string

Sağlık durumunun en son değiştiği zaman damgası (RFC3339).

lastUpdateTime

string

Sağlık durumu en son güncellendiği zaman damgası (RFC3339), durum değişmese bile.

message

string

Son geçişi anlatan insan tarafından okunabilir bir mesaj.

reasonCode

string

Son sağlık durumu geçişinin nedenini açıklayan benzersiz, CamelCase sebep kodu.

status

ResourceHealthState

Kaynağın yüksek düzey sağlık durumu.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string (date-time)

Kaynak oluşturmanın zaman damgası (UTC).

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string (date-time)

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimlik türü.