Dataset Records - Get
Ottiene un record specificato.
GET {endpoint}/datasets/{datasetId}/records/{recordId}?api-version=2023-11-01-preview
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
dataset
|
path | True |
string |
ID del set di dati. |
endpoint
|
path | True |
string uri |
Nome host dello spazio dei nomi, ad esempio admaInstanceName.farmbeats.azure.net |
record
|
path | True |
string |
ID del record. |
api-version
|
query | True |
string |
Versione dell'API richiesta |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
Authorization | True |
string |
Specificare un token di connessione valido per le chiamate API autorizzate. Si noti che potrebbe essere necessario cancellare la cache del browser se si è tentato di eseguire chiamate non autenticate prima. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Operazione completata |
|
Other Status Codes |
Errore Intestazioni x-ms-error-code: string |
Sicurezza
Authorization
Specificare un token di connessione valido per le chiamate API autorizzate. Si noti che potrebbe essere necessario cancellare la cache del browser se si è tentato di eseguire chiamate non autenticate prima.
Tipo:
apiKey
In:
header
Esempio
DatasetRecords_Get
Esempio di richiesta
GET {endpoint}/datasets/Dataset1/records/Record1?api-version=2023-11-01-preview
Risposta di esempio
{
"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"
}
Definizioni
Nome | Descrizione |
---|---|
Dataset |
Schema dei record del set di dati. |
Error |
Errore del servizio Azure AgPlatform. |
Error |
Risposta di errore dal servizio Azure AgPlatform. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses per il documento di riferimento ErrorResponse. |
Inner |
Errore interno contenente l'elenco di errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object per il documento di riferimento InnerError. |
DatasetRecord
Schema dei record del set di dati.
Nome | Tipo | Descrizione |
---|---|---|
createdBy |
string |
Creato dall'ID utente/tenant. |
createdDateTime |
string |
Data-ora in cui è stata creata la risorsa, formato di esempio: aaaa-MM-ddTHH:mm:ssZ. |
datasetId |
string |
ID set di dati per questo record. |
description |
string |
Descrizione testuale della risorsa. |
eTag |
string |
Valore ETag per implementare la concorrenza ottimistica. |
id |
string |
ID risorsa univoco. |
modifiedBy |
string |
Modificato dall'ID utente/tenant. |
modifiedDateTime |
string |
Data-ora dell'ultima modifica della risorsa, formato di esempio: aaaa-MM-ddTHH:mm:ssZ. |
name |
string |
Nome che identifica la risorsa. |
properties |
Raccolta di coppie di valori chiave appartenenti alla risorsa. Ogni coppia non deve avere una chiave maggiore di 50 caratteri e non deve avere un valore maggiore di 150 caratteri. Nota: è possibile specificare un massimo di 25 coppie di valori chiave per una risorsa e solo una stringa, un numero e una datatime (aaaa-MM-ddTHH:mm:ssZ) sono supportati. |
|
record |
Oggetto Record. |
|
source |
string |
Origine della risorsa. |
status |
string |
Stato della risorsa. |
Error
Errore del servizio Azure AgPlatform.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Set definito dal server di codici di errore. |
details |
Error[] |
Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato. |
innererror |
Errore interno contenente l'elenco di errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object per il documento di riferimento InnerError. |
|
message |
string |
Rappresentazione leggibile dell'errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore dal servizio Azure AgPlatform. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses per il documento di riferimento ErrorResponse.
Nome | Tipo | Descrizione |
---|---|---|
error |
Errore del servizio Azure AgPlatform. |
|
traceId |
string |
ID traccia univoco. |
InnerError
Errore interno contenente l'elenco di errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object per il documento di riferimento InnerError.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore specifico rispetto a quello fornito dall'errore contenente. |
innererror |
Errore interno contenente l'elenco di errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object per il documento di riferimento InnerError. |