O Auth Providers - Get

Servizio:

Azure Data Manager for Agriculture

Versione API:

2023-11-01-preview

Ottenere una risorsa oauthProvider specificata.

GET {endpoint}/oauth/providers/{oauthProviderId}?api-version=2023-11-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string uri	Nome host dello spazio dei nomi, ad esempio admaInstanceName.farmbeats.azure.net
oauthProviderId	path	True	string	ID della risorsa oauthProvider.
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	OAuthProvider	Operazione completata
Other Status Codes	ErrorResponse	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

OAuthProviders_Get

Esempio di richiesta

HTTP

GET {endpoint}/oauth/providers/JOHNDEERE?api-version=2023-11-01-preview

Risposta di esempio

Codice di stato:

200

{
  "appId": "appId",
  "appSecret": "appSecret",
  "apiKey": "apiKey",
  "isProductionApp": false,
  "id": "JOHNDEERE",
  "eTag": "f8fad5b-d9cb-469f-a165-70867728950e",
  "createdDateTime": "2021-04-22T18:27:37Z",
  "modifiedDateTime": "2021-04-22T18:27:37Z",
  "name": "JD Integration",
  "description": "Oauth Flow",
  "properties": {
    "Party": "123"
  }
}

Definizioni

Nome	Descrizione
Error	Errore del servizio Azure AgPlatform.
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.
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.
OAuthProvider	Schema della risorsa del provider OAuth.

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	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	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	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.

OAuthProvider

Schema della risorsa del provider OAuth.

Nome	Tipo	Valore predefinito	Descrizione
apiKey	string		Chiave API OAuth per il provider specificato. Nota: attualmente applicabile al provider di clima. Non verrà inviato in risposta.
appId	string		ID app OAuth per il provider OAuth specificato.
appSecret	string		Segreto dell'app OAuth per il provider specificato. Nota: non verrà inviato in risposta.
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.
description	string		Descrizione testuale della risorsa.
eTag	string		Valore ETag per implementare la concorrenza ottimistica.
id	string		ID del provider OAuth univoco.
isProductionApp	boolean	False	Flag facoltativo per determinare se l'app è pronta per essere usata per gli scenari di produzione sul lato provider o meno. (Valore predefinito: false) Nota: attualmente applicabile per JohnDeere.
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.