Freigeben über


Accounts - List By Subscription

Gibt die Liste der Konten zurück.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
subscriptionId
path True

string

Die Azure-Abonnement-ID.

api-version
query True

string

ADU-Schema-API-Version.

Antworten

Name Typ Beschreibung
200 OK

AccountList

Liste der Konten.

Other Status Codes

ErrorResponse

Fehlerantwort, die den Grund für einen Vorgangsfehler beschreibt.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Get list of Accounts

Beispielanforderung

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

Beispiel für eine Antwort

{
  "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"
              ]
            }
          }
        ]
      }
    }
  ]
}

Definitionen

Name Beschreibung
Account

Details des Geräteupdatekontos.

AccountList

Liste der Konten.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Encryption

Die CMK-Verschlüsselungseinstellungen für das Device Update-Konto.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

Location
ManagedServiceIdentity

Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).

PrivateEndpoint

Die Private Endpunktressource.

PrivateEndpointConnection

Die Private Endpunktverbindungsressource.

PrivateEndpointConnectionProvisioningState

Der aktuelle Bereitstellungsstatus.

PrivateEndpointServiceConnectionStatus

Die verbindung mit dem privaten Endpunkt status.

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Verbindungsstatus zwischen Dienstconsumer und Anbieter.

ProvisioningState

Bereitstellungsstatus.

PublicNetworkAccess

Gibt an, ob der Zugriff auf öffentliche Netzwerke für das Konto zulässig ist.

Role

Gibt an, ob es sich um einen primären Standort oder ein Failover handelt.

SKU

Geräteupdate-SKU

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

UserAssignedIdentity

Benutzerseitig zugewiesene Identitätseigenschaften

Account

Details des Geräteupdatekontos.

Name Typ Standardwert Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

Der Identitätstyp, der für die Ressource verwendet wird.

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.encryption

Encryption

CMK-Verschlüsselung ruhender Eigenschaften

properties.hostName

string

API-Hostname.

properties.locations

Location[]

Details zum primären Device Update-Konto und Failoverspeicherort

properties.privateEndpointConnections

PrivateEndpointConnection[]

Liste der privaten Endpunktverbindungen, die dem Konto zugeordnet sind.

properties.provisioningState

ProvisioningState

Bereitstellungsstatus.

properties.publicNetworkAccess

PublicNetworkAccess

Enabled

Gibt an, ob der Zugriff auf öffentliche Netzwerke für das Konto zulässig ist.

properties.sku

SKU

Standard

Geräteupdate-SKU

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

AccountList

Liste der Konten.

Name Typ Beschreibung
nextLink

string

Der Link, der verwendet wird, um die nächste Seite der Kontoliste abzurufen.

value

Account[]

Liste der Konten.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

Encryption

Die CMK-Verschlüsselungseinstellungen für das Device Update-Konto.

Name Typ Beschreibung
keyVaultKeyUri

string

Der URI des Schlüsseltresors

userAssignedIdentity

string

Die vollständige resourceId der vom Benutzer zugewiesenen Identität, die für den Schlüsseltresorzugriff verwendet werden soll. Die Identität muss ebenfalls dem Konto zugewiesen werden.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

Location

Name Typ Standardwert Beschreibung
name

string

role

Role

Primary

Gibt an, ob es sich um einen primären Standort oder ein Failover handelt.

ManagedServiceIdentity

Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)

Name Typ Beschreibung
principalId

string

Die Dienstprinzipal-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.

tenantId

string

Die Mandanten-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.

type

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned Identitäten
Der Satz von benutzerseitig zugewiesenen Identitäten, die der Ressource zugeordnet sind. Bei den userAssignedIdentities-Wörterbuchschlüsseln handelt es sich um ARM-Ressourcen-IDs im Format :/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).

Name Typ Beschreibung
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

PrivateEndpoint

Die Private Endpunktressource.

Name Typ Beschreibung
id

string

Der ARM-Bezeichner für den privaten Endpunkt

PrivateEndpointConnection

Die Private Endpunktverbindungsressource.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Der Name der Ressource

properties.groupIds

string[]

Array von Gruppen-IDs.

properties.privateEndpoint

PrivateEndpoint

Die Ressource des privaten Endpunkts.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Verbindungsstatus zwischen Dienstconsumer und Anbieter.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Der Bereitstellungsstatus der Verbindungsressource des privaten Endpunkts.

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Der aktuelle Bereitstellungsstatus.

Name Typ Beschreibung
Creating

string

Deleting

string

Failed

string

Succeeded

string

PrivateEndpointServiceConnectionStatus

Die verbindung mit dem privaten Endpunkt status.

Name Typ Beschreibung
Approved

string

Pending

string

Rejected

string

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Verbindungsstatus zwischen Dienstconsumer und Anbieter.

Name Typ Beschreibung
actionsRequired

string

Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Consumer erfordern.

description

string

Der Grund für die Genehmigung/Ablehnung der Verbindung.

status

PrivateEndpointServiceConnectionStatus

Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde.

ProvisioningState

Bereitstellungsstatus.

Name Typ Beschreibung
Accepted

string

Canceled

string

Creating

string

Deleted

string

Failed

string

Succeeded

string

PublicNetworkAccess

Gibt an, ob der Zugriff auf öffentliche Netzwerke für das Konto zulässig ist.

Name Typ Beschreibung
Disabled

string

Enabled

string

Role

Gibt an, ob es sich um einen primären Standort oder ein Failover handelt.

Name Typ Beschreibung
Failover

string

Primary

string

SKU

Geräteupdate-SKU

Name Typ Beschreibung
Free

string

Standard

string

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

UserAssignedIdentity

Benutzerseitig zugewiesene Identitätseigenschaften

Name Typ Beschreibung
clientId

string

Die Client-ID der zugewiesenen Identität.

principalId

string

Die Prinzipal-ID der zugewiesenen Identität.