Api Tokens - List

Service:

IoT Central

API Version:

2022-07-31

Ottenere l'elenco di token API in un'applicazione. Il valore del token non verrà mai restituito per motivi di sicurezza.

GET https://{subdomain}.{baseDomain}/api/apiTokens?api-version=2022-07-31

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
baseDomain	path	True	string	Dominio di base per tutte le richieste di servizio Azure IoT Central.
subdomain	path	True	string	Sottodominio dell'applicazione.
api-version	query	True	string	Versione dell'API chiamata.

Risposte

Nome	Tipo	Descrizione
200 OK	ApiTokenCollection	Operazione riuscita
Other Status Codes	Error	Risposta di errore ricevuta dal servizio IoT Central. Headers x-ms-error-code: string

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

List API tokens

Sample Request

HTTP

GET https://appsubdomain.azureiotcentral.com/api/apiTokens?api-version=2022-07-31

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "testtoken",
      "roles": [
        {
          "role": "ca310b8d-2f4a-44e0-a36e-957c202cd8d4"
        },
        {
          "role": "c495eb57-eb18-489e-9802-62c474e5645c",
          "organization": "seattle"
        }
      ],
      "expiry": "2020-10-18T18:30:40.227Z"
    }
  ]
}

Definizioni

Nome	Descrizione
ApiToken	Definizione del token di accesso all'API.
ApiTokenCollection	Risultati paginati dei token API.
Error	Definizione dell'errore di risposta.
ErrorDetails	Informazioni dettagliate sull'errore.
RoleAssignment	Definizione dell'assegnazione di ruolo.

ApiToken

Definizione del token di accesso all'API.

Nome	Tipo	Descrizione
expiry	string	Data formattata con stringa che rappresenta l'ora in cui scade il token.
id	string	ID univoco del token API.
roles	RoleAssignment[]	Elenco delle assegnazioni di ruolo che specificano le autorizzazioni per accedere all'applicazione.
token	string	Valore del token API.

ApiTokenCollection

Risultati paginati dei token API.

Nome	Tipo	Descrizione
nextLink	string	URL per ottenere la pagina successiva dei token API.
value	ApiToken[]	Raccolta di token API.

Error

Definizione dell'errore di risposta.

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli degli errori per la richiesta corrente.

ErrorDetails

Informazioni dettagliate sull'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Dettagli del messaggio di errore.
requestId	string	ID di correlazione per la richiesta corrente.
time	string	Ora in cui la richiesta di errore non è riuscita.

RoleAssignment

Definizione dell'assegnazione di ruolo.

Nome	Tipo	Descrizione
organization	string	ID dell'organizzazione per questa assegnazione di ruolo.
role	string	ID del ruolo per questa assegnazione di ruolo.