Condividi tramite


Accounts - List By Subscription

Restituisce un elenco di account.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DeviceUpdate/accounts?api-version=2023-07-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
subscriptionId
path True

string

ID sottoscrizione di Azure.

api-version
query True

string

Versione dell'API dello schema ADU.

Risposte

Nome Tipo Descrizione
200 OK

AccountList

Elenco di account.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo dell'errore dell'operazione.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation Rappresentare l'account utente

Esempio

Get list of Accounts

Esempio di richiesta

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.DeviceUpdate/accounts?api-version=2023-07-01

Risposta di esempio

{
  "nextLink": "string",
  "value": [
    {
      "name": "contoso",
      "location": "westus2",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DeviceUpdate/accounts/contoso",
      "type": "Microsoft.DeviceUpdate/accounts",
      "properties": {
        "provisioningState": "Succeeded",
        "hostName": "contoso.api.adu.microsoft.com",
        "sku": "Standard",
        "locations": [
          {
            "name": "westus2",
            "role": "Primary"
          },
          {
            "name": "westcentralus",
            "role": "Failover"
          }
        ],
        "privateEndpointConnections": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DeviceUpdate/accounts/contoso/privateEndpointConnections/peexample01",
            "name": "peexample01",
            "type": "Microsoft.DeviceUpdate/accounts/privateEndpointConnections",
            "properties": {
              "provisioningState": "Succeeded",
              "privateEndpoint": {
                "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Network/privateEndpoints/peexample01"
              },
              "privateLinkServiceConnectionState": {
                "status": "Approved",
                "description": "Auto-Approved",
                "actionsRequired": "None"
              },
              "groupIds": [
                "groupId"
              ]
            }
          }
        ]
      }
    }
  ]
}

Definizioni

Nome Descrizione
Account

Dettagli dell'account di Aggiornamento dispositivi.

AccountList

Elenco di account.

createdByType

Tipo di identità che ha creato la risorsa.

Encryption

Impostazioni di crittografia della chiave gestita dal cliente nell'account Aggiornamento dispositivi.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

Location
ManagedServiceIdentity

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti i tipi SystemAssigned e UserAssigned).

PrivateEndpoint

Risorsa endpoint privato.

PrivateEndpointConnection

Risorsa Connessione endpoint privato.

PrivateEndpointConnectionProvisioningState

Stato di provisioning corrente.

PrivateEndpointServiceConnectionStatus

Stato della connessione dell'endpoint privato.

PrivateLinkServiceConnectionState

Raccolta di informazioni sullo stato della connessione tra il consumer del servizio e il provider.

ProvisioningState

Stato del provisioning.

PublicNetworkAccess

Indica se l'accesso alla rete pubblica è consentito per l'account.

Role

Indica se il percorso è primario o failover

SKU

SKU aggiornamento dispositivi

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

UserAssignedIdentity

Proprietà di identità assegnate dall'utente

Account

Dettagli dell'account di Aggiornamento dispositivi.

Nome Tipo Valore predefinito Descrizione
id

string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

Tipo di identità usata per la risorsa.

location

string

Posizione geografica in cui risiede la risorsa

name

string

nome della risorsa.

properties.encryption

Encryption

Crittografia della chiave gestita dal cliente inattivi

properties.hostName

string

Nome host API.

properties.locations

Location[]

Dettagli del percorso primario e del percorso di failover dell'account di Aggiornamento dispositivi

properties.privateEndpointConnections

PrivateEndpointConnection[]

Elenco delle connessioni di endpoint privato associate all'account.

properties.provisioningState

ProvisioningState

Stato del provisioning.

properties.publicNetworkAccess

PublicNetworkAccess

Enabled

Indica se l'accesso alla rete pubblica è consentito per l'account.

properties.sku

SKU

Standard

SKU aggiornamento dispositivi

systemData

systemData

Azure Resource Manager metadati contenenti le informazioni createdBy e modifiedBy.

tags

object

Tag delle risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AccountList

Elenco di account.

Nome Tipo Descrizione
nextLink

string

Collegamento utilizzato per ottenere la pagina successiva dell'elenco Account.

value

Account[]

Elenco di account.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

Encryption

Impostazioni di crittografia della chiave gestita dal cliente nell'account Aggiornamento dispositivi.

Nome Tipo Descrizione
keyVaultKeyUri

string

URI dell'insieme di credenziali delle chiavi

userAssignedIdentity

string

ResourceId completo dell'identità assegnata dall'utente da usare per l'accesso all'insieme di credenziali delle chiavi. L'identità deve essere assegnata anche all'account

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

Location

Nome Tipo Valore predefinito Descrizione
name

string

role

Role

Primary

Indica se il percorso è primario o failover

ManagedServiceIdentity

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome Tipo Descrizione
principalId

string

ID dell'entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.

tenantId

string

ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.

type

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti i tipi SystemAssigned e UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

identità User-Assigned
Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti i tipi SystemAssigned e UserAssigned).

Nome Tipo Descrizione
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

PrivateEndpoint

Risorsa endpoint privato.

Nome Tipo Descrizione
id

string

Identificatore arm per endpoint privato

PrivateEndpointConnection

Risorsa Connessione endpoint privato.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

nome della risorsa.

properties.groupIds

string[]

Matrice di ID gruppo.

properties.privateEndpoint

PrivateEndpoint

Risorsa dell'endpoint privato.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Raccolta di informazioni sullo stato della connessione tra il consumer del servizio e il provider.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Stato di provisioning della risorsa di connessione dell'endpoint privato.

systemData

systemData

Azure Resource Manager metadati contenenti le informazioni createdBy e modifiedBy.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Stato di provisioning corrente.

Nome Tipo Descrizione
Creating

string

Deleting

string

Failed

string

Succeeded

string

PrivateEndpointServiceConnectionStatus

Stato della connessione dell'endpoint privato.

Nome Tipo Descrizione
Approved

string

Pending

string

Rejected

string

PrivateLinkServiceConnectionState

Raccolta di informazioni sullo stato della connessione tra il consumer del servizio e il provider.

Nome Tipo Descrizione
actionsRequired

string

Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti nel consumer.

description

string

Motivo dell'approvazione/rifiuto della connessione.

status

PrivateEndpointServiceConnectionStatus

Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio.

ProvisioningState

Stato del provisioning.

Nome Tipo Descrizione
Accepted

string

Canceled

string

Creating

string

Deleted

string

Failed

string

Succeeded

string

PublicNetworkAccess

Indica se l'accesso alla rete pubblica è consentito per l'account.

Nome Tipo Descrizione
Disabled

string

Enabled

string

Role

Indica se il percorso è primario o failover

Nome Tipo Descrizione
Failover

string

Primary

string

SKU

SKU aggiornamento dispositivi

Nome Tipo Descrizione
Free

string

Standard

string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedIdentity

Proprietà di identità assegnate dall'utente

Nome Tipo Descrizione
clientId

string

ID client dell'identità assegnata.

principalId

string

ID principale dell'identità assegnata.