Resources - List

Referenz

Service:: Resource Management

API Version:: 2021-04-01

Rufen Sie alle Ressourcen in einem Abonnement ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resources?api-version=2021-04-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resources?$filter={$filter}&$expand={$expand}&$top={$top}&api-version=2021-04-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
subscriptionId	path	True	string	Die Microsoft Azure-Abonnement-ID.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.
$expand	query		string	Durch Trennzeichen getrennte Liste zusätzlicher Eigenschaften, die in die Antwort aufgenommen werden sollen. Gültige Werte sind , `createdTimechangedTime` und `provisioningState`. Beispiel: `$expand=createdTime,changedTime`.
$filter	query		string	Der Filter, der auf den Vorgang angewendet werden soll. Filtervergleichsoperatoren umfassen `eq` (gleich) und `ne` (nicht gleich) und können mit den folgenden Eigenschaften verwendet werden: `location`, , `resourceType`, `resourceGroupname`, `identity`, `identity/principalId`, , `plan`, `plan/publisher`, `plan/product`, `plan/name`, `plan/version`, und `plan/promotionCode`. Um beispielsweise nach einem Ressourcentyp zu filtern, verwenden Sie `$filter=resourceType eq 'Microsoft.Network/virtualNetworks'` `substringof(value, property)` kann verwendet werden, um nach Teilzeichenfolgen der folgenden derzeit unterstützten Eigenschaften zu filtern: `name` und `resourceGroup` Verwenden Sie beispielsweise, um alle Ressourcen mit "demo" an einer beliebigen Stelle im Ressourcennamen abzurufen. `$filter=substringof('demo', name)` Mehrere Teilzeichenfolgenvorgänge können auch mithilfe von `and`/`or` Operatoren kombiniert werden. Beachten Sie, dass die abgeschnittene Anzahl der über `$top` abgefragten Ergebnisse möglicherweise auch nicht kompatibel ist, wenn ein Filter verwendet wird. Ressourcen können nach Tagnamen und -werten gefiltert werden. Um beispielsweise nach einem Tagnamen und -wert zu filtern, verwenden Sie `$filter=tagName eq 'tag1' and tagValue eq 'Value1'`. Beachten Sie, dass beim Filtern von Ressourcen nach Tagname und -wert die ursprünglichen Tags für jede Ressource nicht in den Ergebnissen zurückgegeben werden. Jede Liste mit zusätzlichen Eigenschaften, die über `$expand` abgefragt werden, ist möglicherweise auch nicht kompatibel, wenn nach Tagnamen/Werten gefiltert wird. Nur für Tagnamen können Ressourcen mithilfe der folgenden Syntax nach Präfix gefiltert werden: `$filter=startswith(tagName, 'depart')`. Diese Abfrage gibt alle Ressourcen mit einem Tagnamen zurück, `departureDate`dem der Ausdruck `depart` vorangestellt ist (d. h.`department` , `departureTime`usw.). Beachten Sie, dass einige Eigenschaften beim Filtern von Ressourcen kombiniert werden können, darunter die folgenden: `substringof() and/or resourceType`, `plan and plan/publisher and plan/name`und `identity and identity/principalId`.
$top	query		integer int32	Die Anzahl der Empfehlungen pro Seite, wenn eine ausgelagerte Version dieser API verwendet wird.

Antworten

Name	Typ	Beschreibung
200 OK	ResourceListResult	OK: Gibt ein Array von Ressourcen zurück.
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorResponse	Fehlerantwort
ExtendedLocation	Erweiterter Speicherort der Ressource.
ExtendedLocationType	Der erweiterte Standorttyp.
GenericResourceExpanded	Ressourceninformationen
Identity	Identität für die Ressource.
Plan	Plant für die Ressource.
ResourceIdentityType	Der Identitätstyp.
ResourceListResult	Liste der Ressourcengruppen.
Sku	SKU für die Ressource.
UserAssignedIdentities	Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Bei den Referenzdaten des Benutzeridentitätswörterbuchs handelt es sich um ARM-Ressourcen-IDs in der Form : "/subscriptions/{subscriptionId}/resourceGroupGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name	Typ	Beschreibung
error	ErrorResponse	Fehlerantwort Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorResponse[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ExtendedLocation

Erweiterter Speicherort der Ressource.

Name	Typ	Beschreibung
name	string	Der Name des erweiterten Speicherorts.
type	ExtendedLocationType	Der erweiterte Standorttyp.

ExtendedLocationType

Der erweiterte Standorttyp.

Name	Typ	Beschreibung
EdgeZone	string

GenericResourceExpanded

Ressourceninformationen

Name	Typ	Beschreibung
changedTime	string	Die geänderte Zeit der Ressource. Dies ist nur vorhanden, wenn sie über den abfrageparameter $expand angefordert wird.
createdTime	string	Die erstellungszeit der Ressource. Dies ist nur vorhanden, wenn sie über den abfrageparameter $expand angefordert wird.
extendedLocation	ExtendedLocation	Erweiterter Speicherort der Ressource.
id	string	Ressourcen-ID
identity	Identity	Die Identität der Ressource.
kind	string	Die Art der Ressource.
location	string	Ressourcenspeicherort
managedBy	string	ID der Ressource, die diese Ressource verwaltet.
name	string	Ressourcenname
plan	Plan	Der Plan der Ressource.
properties	object	Die Ressourceneigenschaften.
provisioningState	string	Der Bereitstellungsstatus der Ressource. Dies ist nur vorhanden, wenn sie über den abfrageparameter $expand angefordert wird.
sku	Sku	Die SKU der Ressource.
tags	object	Ressourcentags
type	string	Ressourcentyp

Identity

Identität für die Ressource.

Name	Typ	Beschreibung
principalId	string	Die Prinzipal-ID der Ressourcenidentität.
tenantId	string	Die Mandanten-ID der Ressource.
type	ResourceIdentityType	Der Identitätstyp.
userAssignedIdentities	UserAssignedIdentities	Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Bei den Referenzdaten des Benutzeridentitätswörterbuchs handelt es sich um ARM-Ressourcen-IDs in der Form : "/subscriptions/{subscriptionId}/resourceGroupGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Plan

Plant für die Ressource.

Name	Typ	Beschreibung
name	string	Die Plan-ID.
product	string	Die Angebots-ID.
promotionCode	string	Der Promotionscode.
publisher	string	Die Herausgeber-ID.
version	string	Die Version des Plans.

ResourceIdentityType

Der Identitätstyp.

Name	Typ	Beschreibung
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

ResourceListResult

Liste der Ressourcengruppen.

Name	Typ	Beschreibung
nextLink	string	Die URL, die zum Abrufen der nächsten Ergebnismenge verwendet werden soll.
value	GenericResourceExpanded[]	Ein Array von Ressourcen.

Sku

SKU für die Ressource.

Name	Typ	Beschreibung
capacity	integer	Die SKU-Kapazität.
family	string	Die SKU-Familie.
model	string	Das SKU-Modell.
name	string	Der SKU-Name.
size	string	Die SKU-Größe.
tier	string	Die SKU-Ebene.

UserAssignedIdentities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Bei den Referenzdaten des Benutzeridentitätswörterbuchs handelt es sich um ARM-Ressourcen-IDs in der Form : "/subscriptions/{subscriptionId}/resourceGroupGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Name	Typ	Beschreibung

Share via