Sensor Data Models - Create Or Update

참조

서비스:: Azure Data Manager for Agriculture

API 버전:: 2023-11-01-preview

센서 데이터 모델 엔터티를 만듭니다.

PATCH {endpoint}/sensor-partners/{sensorPartnerId}/sensor-data-models/{sensorDataModelId}?api-version=2023-11-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string uri	네임스페이스의 호스트 이름(예: admaInstanceName.farmbeats.azure.net
sensorDataModelId	path	True	string	센서 데이터 모델의 ID입니다.
sensorPartnerId	path	True	string	센서 파트너의 ID입니다.
api-version	query	True	string	요청된 API 버전

요청 헤더

Media Types: "application/merge-patch+json"

Name	필수	형식	Description
Authorization	True	string	권한 있는 API 호출에 유효한 전달자 토큰을 제공하세요. 이전에 인증되지 않은 호출을 시도한 경우 브라우저 캐시를 지워야 할 수 있습니다.

요청 본문

Media Types: "application/merge-patch+json"

Name	필수	형식	Description
measures	True	<string, SensorDataModelMeasure>	센서 형식을 센서 측정값에 매핑합니다.
description		string	리소스에 대한 텍스트 형식의 설명입니다.
manufacturer		string	센서 제조업체.
name		string	리소스를 식별하는 이름입니다.
productCode		string	센서 productCode.
properties			리소스에 속하는 키 값 쌍의 컬렉션입니다. 각 쌍에는 50자보다 큰 키가 없어야 하며 150자보다 큰 값은 없어야 합니다. 참고: 리소스에 대해 최대 25개의 키 값 쌍을 제공할 수 있으며 문자열, 숫자 및 날짜/시간(yyyy-MM-ddTHH:mm:ssZ) 값만 지원됩니다.
status		string	리소스의 상태입니다.
type		string	센서 유형입니다.

응답

Name	형식	Description
200 OK	SensorDataModel	성공
201 Created	SensorDataModel	생성일
Other Status Codes	ErrorResponse	오류 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

SensorDataModel

성공

201 Created

SensorDataModel

생성일

Other Status Codes

ErrorResponse

오류

헤더

x-ms-error-code: string

보안

Authorization

권한 있는 API 호출에 유효한 전달자 토큰을 제공하세요. 이전에 인증되지 않은 호출을 시도한 경우 브라우저 캐시를 지워야 할 수 있습니다.

형식: apiKey
In(다음 안에): header

예제

SensorDataModels_CreateOrUpdate

샘플 요청

HTTP

PATCH {endpoint}/sensor-partners/sp1/sensor-data-models/sdm124?api-version=2023-11-01-preview

{
  "type": "Sensor",
  "manufacturer": "Some sensor manufacturer",
  "productCode": "soil m",
  "measures": {
    "soilMoisture": {
      "description": "measures soil moisture",
      "dataType": "Bool",
      "type": "sm",
      "unit": "none",
      "properties": {
        "abc": "def",
        "elevation": 5
      }
    }
  },
  "status": "new",
  "name": "my sdm for soil moisture",
  "description": "description goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

샘플 응답

상태 코드:: 200

{
  "type": "Sensor",
  "manufacturer": "Some sensor manufacturer",
  "productCode": "soil m",
  "measures": {
    "soilMoisture": {
      "description": "measures soil moisture",
      "dataType": "Bool",
      "type": "sm",
      "unit": "none",
      "properties": {
        "abc": "def",
        "elevation": 5
      }
    }
  },
  "sensorPartnerId": "sp1",
  "id": "sdm124",
  "status": "new",
  "createdDateTime": "2022-01-24T06:12:15Z",
  "modifiedDateTime": "2022-01-24T06:12:42Z",
  "eTag": "040161a2-0000-0700-0000-61ee435a0000",
  "name": "my sdm for soil moisture",
  "description": "description goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

상태 코드:: 201

{
  "type": "Sensor",
  "manufacturer": "Some sensor manufacturer",
  "productCode": "soil m",
  "measures": {
    "soilMoisture": {
      "description": "measures soil moisture",
      "dataType": "Bool",
      "type": "sm",
      "unit": "none",
      "properties": {
        "abc": "def",
        "elevation": 5
      }
    }
  },
  "sensorPartnerId": "sp1",
  "id": "sdm124",
  "status": "new",
  "createdDateTime": "2022-01-24T06:12:15Z",
  "modifiedDateTime": "2022-01-24T06:12:15Z",
  "eTag": "040158a0-0000-0700-0000-61ee433f0000",
  "name": "my sdm for soil moisture",
  "description": "description goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

정의

Name	Description
Error	Azure AgPlatform 서비스의 오류입니다.
ErrorResponse	Azure AgPlatform 서비스의 오류 응답입니다. ErrorResponse 참조 문서는 를 참조하세요 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses .
InnerError	오류 목록을 포함하는 내부 오류입니다. InnerError 참조 문서는 를 참조하세요 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object .
SensorDataModel	SensorModel API 모델.
SensorDataModelMeasure	센서 모델 측정 세부 정보입니다.
SensorDataType	센서 측정 데이터 형식입니다.

Error

Azure AgPlatform 서비스의 오류입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합입니다.
details	Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	InnerError	오류 목록을 포함하는 내부 오류입니다. InnerError 참조 문서는 를 참조하세요 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object .
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

ErrorResponse

Azure AgPlatform 서비스의 오류 응답입니다. ErrorResponse 참조 문서는 를 참조하세요 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses .

Name	형식	Description
error	Error	Azure AgPlatform 서비스의 오류입니다.
traceId	string	고유 추적 ID입니다.

InnerError

오류 목록을 포함하는 내부 오류입니다. InnerError 참조 문서는 를 참조하세요 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object .

Name	형식	Description
code	string	포함된 오류에서 제공한 것보다 구체적인 오류 코드입니다.
innererror	InnerError	오류 목록을 포함하는 내부 오류입니다. InnerError 참조 문서는 를 참조하세요 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object .

SensorDataModel

SensorModel API 모델.

Name	형식	Description
createdBy	string	사용자/테넌트 ID로 생성됩니다.
createdDateTime	string	리소스가 생성된 날짜-시간입니다(샘플 형식: yyyy-MM-ddTHH:mm:ssZ).
description	string	리소스에 대한 텍스트 형식의 설명입니다.
eTag	string	낙관적 동시성을 구현하는 ETag 값입니다.
id	string	리소스의 ID입니다.
manufacturer	string	센서 제조업체.
measures	<string, SensorDataModelMeasure>	센서 형식을 센서 측정값에 매핑합니다.
modifiedBy	string	사용자/테넌트 ID로 수정되었습니다.
modifiedDateTime	string	리소스가 마지막으로 수정된 날짜-시간입니다(샘플 형식: yyyy-MM-ddTHH:mm:ssZ).
name	string	리소스를 식별하는 이름입니다.
productCode	string	센서 productCode.
properties		리소스에 속하는 키 값 쌍의 컬렉션입니다. 각 쌍에는 50자보다 큰 키가 없어야 하며 150자보다 큰 값은 없어야 합니다. 참고: 리소스에 대해 최대 25개의 키 값 쌍을 제공할 수 있으며 문자열, 숫자 및 날짜/시간(yyyy-MM-ddTHH:mm:ssZ) 값만 지원됩니다.
sensorPartnerId	string	연결된 센서 파트너의 ID입니다.
status	string	리소스의 상태입니다.
type	string	센서 유형입니다.

SensorDataModelMeasure

센서 모델 측정 세부 정보입니다.

Name	형식	Description
dataType	SensorDataType	센서 측정 데이터 형식입니다.
description	string	센서 측정값에 대한 설명입니다.
properties		센서 데이터 모델에 대한 키 값 쌍의 컬렉션입니다. 각 쌍에는 50자보다 큰 키가 없어야 하며 150자보다 큰 값은 없어야 합니다. 참고: 모델에 대해 최대 25개의 키 값 쌍을 제공할 수 있으며 문자열, 숫자 및 날짜/시간(yyyy-MM-ddTHH:mm:ssZ) 값만 지원됩니다.
type	string	센서 데이터의 측정 유형입니다.
unit	string	센서 측정 단위입니다.

SensorDataType

센서 측정 데이터 형식입니다.

Name	형식	Description
Bool	string
DateTime	string
Double	string
Long	string
String	string

다음을 통해 공유

Sensor Data Models - Create Or Update

URI 매개 변수

요청 헤더

요청 본문

응답

보안

Authorization

예제

SensorDataModels_CreateOrUpdate

샘플 요청

샘플 응답

정의

Error

ErrorResponse

InnerError

SensorDataModel

SensorDataModelMeasure

SensorDataType

추가 리소스