O Auth Providers - Create Or Update
Crea o aggiorna una risorsa oauthProvider.
PATCH {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 |
oauth
|
path | True |
string |
ID della risorsa oauthProvider. |
api-version
|
query | True |
string |
Versione dell'API richiesta |
Intestazione della richiesta
Media Types: "application/merge-patch+json"
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. |
Corpo della richiesta
Media Types: "application/merge-patch+json"
Nome | Tipo | Descrizione |
---|---|---|
apiKey |
string |
Chiave API OAuth per un determinato provider. Nota: attualmente applicabile al provider di clima. Non verrà inviato in risposta. |
appId |
string |
ID app OAuth per un provider OAuth specificato. |
appSecret |
string |
Segreto dell'app OAuth per un determinato provider. Nota: non verrà inviato in risposta. |
description |
string |
Descrizione testuale della risorsa. |
isProductionApp |
boolean |
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. |
name |
string |
Nome che identifica la risorsa. |
properties |
Raccolta di coppie chiave-valore 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 chiave-valore per una risorsa e sono supportati solo valori stringa, numerali e datetime (aa-MM-ggTHH:mm:ssZ). |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Operazione completata |
|
201 Created |
Data di creazione |
|
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
OAuthProviders_CreateOrUpdate
Esempio di richiesta
PATCH {endpoint}/oauth/providers/JOHNDEERE?api-version=2023-11-01-preview
{
"appId": "appId",
"appSecret": "appSecret",
"apiKey": "apiKey",
"isProductionApp": false,
"name": "JOHNDEERE",
"description": "some description",
"properties": {
"orgId": "ORG123"
}
}
Risposta di esempio
{
"id": "JOHNDEERE",
"appId": "appId",
"appSecret": "appSecret",
"apiKey": "apiKey",
"isProductionApp": false,
"name": "JOHNDEERE",
"description": "some description",
"properties": {
"orgId": "ORG123"
},
"eTag": "0f8fad5b-d9cb-469f-a165-70867728950e",
"createdDateTime": "2021-04-23T11:31:10Z",
"modifiedDateTime": "2021-04-23T11:31:10Z"
}
{
"id": "JOHNDEERE",
"appId": "appId",
"appSecret": "appSecret",
"apiKey": "apiKey",
"isProductionApp": false,
"name": "JOHNDEERE",
"description": "some description",
"properties": {
"orgId": "ORG123"
},
"eTag": "0f8fad5b-d9cb-469f-a165-70867728950e",
"createdDateTime": "2021-04-23T11:31:10Z",
"modifiedDateTime": "2021-04-23T11:31:10Z"
}
Definizioni
Nome | Descrizione |
---|---|
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 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 il documento di riferimento per InnerError. |
OAuth |
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 questo errore segnalato. |
innererror |
Errore interno contenente l'elenco di errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object il documento di riferimento per 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 il documento di riferimento ErrorResponse.
Nome | Tipo | Descrizione |
---|---|---|
error |
Errore del servizio Azure AgPlatform. |
|
traceId |
string |
ID di traccia univoco. |
InnerError
Errore interno contenente l'elenco di errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object il documento di riferimento per InnerError.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore specifico di quello fornito dall'errore che lo contiene. |
innererror |
Errore interno contenente l'elenco di errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object il documento di riferimento per InnerError. |
OAuthProvider
Schema della risorsa del provider OAuth.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
apiKey |
string |
Chiave API OAuth per un determinato provider. Nota: attualmente applicabile al provider di clima. Non verrà inviato in risposta. |
|
appId |
string |
ID app OAuth per un provider OAuth specificato. |
|
appSecret |
string |
Segreto dell'app OAuth per un determinato provider. Nota: non verrà inviato in risposta. |
|
createdBy |
string |
Creato dall'ID utente/tenant. |
|
createdDateTime |
string |
Data e ora di creazione della risorsa, formato di esempio: a-MM-ggTHH:mm:ssZ. |
|
description |
string |
Descrizione testuale della risorsa. |
|
eTag |
string |
Valore ETag per implementare la concorrenza ottimistica. |
|
id |
string |
ID 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 e ora dell'ultima modifica della risorsa, formato di esempio: aaaa-MM-ggTHH:mm:ssZ. |
|
name |
string |
Nome che identifica la risorsa. |
|
properties |
Raccolta di coppie chiave-valore 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 chiave-valore per una risorsa e sono supportati solo valori stringa, numerali e datetime (aa-MM-ggTHH:mm:ssZ). |