Freigeben über


Dataset Records - Get

Ruft einen angegebenen Datensatz ab.

GET {endpoint}/datasets/{datasetId}/records/{recordId}?api-version=2023-11-01-preview

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
path True

string

ID des Datasets.

endpoint
path True

string

uri

Der Hostname des Namespace, z. B. admaInstanceName.farmbeats.azure.net

recordId
path True

string

ID des Datensatzes.

api-version
query True

string

Die angeforderte API-Version

Anforderungsheader

Name Erforderlich Typ Beschreibung
Authorization True

string

Geben Sie ein gültiges Bearertoken für autorisierte API-Aufrufe an. Beachten Sie, dass Sie ihren Browsercache möglicherweise löschen müssen, wenn Sie zuvor nicht authentifizierte Aufrufe ausprobiert haben.

Antworten

Name Typ Beschreibung
200 OK

DatasetRecord

Erfolg

Other Status Codes

ErrorResponse

Fehler

Header

x-ms-error-code: string

Sicherheit

Authorization

Geben Sie ein gültiges Bearertoken für autorisierte API-Aufrufe an. Beachten Sie, dass Sie ihren Browsercache möglicherweise löschen müssen, wenn Sie zuvor nicht authentifizierte Aufrufe ausprobiert haben.

Typ: apiKey
In: header

Beispiele

DatasetRecords_Get

Beispielanforderung

GET {endpoint}/datasets/Dataset1/records/Record1?api-version=2023-11-01-preview

Beispiel für eine Antwort

{
  "datasetId": "Dataset1",
  "record": {
    "name": "Cimegra",
    "code": "cimegra",
    "Company": "BASF",
    "MatterStateCode": "liquid",
    "RegulatorNumbers": [
      "33666"
    ],
    "ChemicalTypeCodes": [
      "insecticide"
    ],
    "ChemicalTypeNames": [
      "Insecticide"
    ],
    "SubstanceCodes": [
      "broflanilide"
    ],
    "SubstanceNames": [
      "Broflanilide"
    ],
    "SubstancePercentages": 10,
    "CreatedAtDate": "2023-05-30T11:10:21Z",
    "UpdatedAtDate": "2023-06-30T11:10:21Z"
  },
  "id": "Record1",
  "status": "string",
  "source": "string",
  "name": "string",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  },
  "createdDateTime": "2021-04-21T06:49:30Z",
  "modifiedDateTime": "2021-04-21T06:49:30Z",
  "createdBy": "00000000-0000-0000-0000-000000000000",
  "modifiedBy": "00000000-0000-0000-0000-000000000000",
  "eTag": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Definitionen

Name Beschreibung
DatasetRecord

Schema der Datasetdatensätze.

Error

Ein Fehler vom Azure AgPlatform-Dienst.

ErrorResponse

Eine Fehlerantwort des Azure AgPlatform-Diensts. Weitere Informationen finden Sie https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses unter Referenzdokument zu ErrorResponse.

InnerError

Innerer Fehler, der eine Fehlerliste enthält. Weitere Informationen finden Sie https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object unter Referenzdokument zu InnerError.

DatasetRecord

Schema der Datasetdatensätze.

Name Typ Beschreibung
createdBy

string

Erstellt von Benutzer-/Mandanten-ID.

createdDateTime

string

Datum und Uhrzeit der Erstellung der Ressource, Beispielformat: jjjj-MM-ttTHH:mm:ssZ.

datasetId

string

Dataset-ID für diesen Datensatz.

description

string

Textbeschreibung der Ressource.

eTag

string

Der ETag-Wert, um optimistische Parallelität zu implementieren.

id

string

Eindeutige Ressourcen-ID.

modifiedBy

string

Geändert durch Benutzer-/Mandanten-ID.

modifiedDateTime

string

Datum und Uhrzeit der letzten Änderung der Ressource, Beispielformat: jjjj-MM-ttTHH:mm:ssZ.

name

string

Der Name zur Identifizierung der Ressource.

properties

Eine Auflistung von Schlüsselwertpaaren, die zur Ressource gehören. Jedes Paar darf keinen Schlüssel haben, der größer als 50 Zeichen ist, und darf keinen Wert größer als 150 Zeichen haben. Hinweis: Für eine Ressource können maximal 25 Schlüsselwertpaare bereitgestellt werden, und es werden nur Zeichenfolgen-, Numeral- und datetime-Werte (yyyy-MM-ddTHH:mm:ssZ) unterstützt.

record

Record-Objekt.

source

string

Quelle der Ressource.

status

string

Status der Ressource.

Error

Ein Fehler vom Azure AgPlatform-Dienst.

Name Typ Beschreibung
code

string

Serverdefinierter Satz von Fehlercodes.

details

Error[]

Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.

innererror

InnerError

Innerer Fehler, der eine Fehlerliste enthält. Weitere Informationen finden Sie https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object unter Referenzdokument zu InnerError.

message

string

Lesbare Darstellung des Fehlers.

target

string

Ziel des Fehlers.

ErrorResponse

Eine Fehlerantwort des Azure AgPlatform-Diensts. Weitere Informationen finden Sie https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses unter Referenzdokument zu ErrorResponse.

Name Typ Beschreibung
error

Error

Ein Fehler vom Azure AgPlatform-Dienst.

traceId

string

Eindeutige Ablaufverfolgungs-ID.

InnerError

Innerer Fehler, der eine Fehlerliste enthält. Weitere Informationen finden Sie https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object unter Referenzdokument zu InnerError.

Name Typ Beschreibung
code

string

Spezifischer Fehlercode, der vom enthaltenden Fehler bereitgestellt wurde.

innererror

InnerError

Innerer Fehler, der eine Fehlerliste enthält. Weitere Informationen finden Sie https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object unter Referenzdokument zu InnerError.