Share via


Resources - List By Resource Group

Rufen Sie alle Ressourcen für eine Ressourcengruppe ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Die Ressourcengruppe mit den abzurufenden Ressourcen.

Regex pattern: ^[-\w\._\(\)]+$

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.

Die Eigenschaften, die Sie für eq (gleich) oder ne (nicht gleich) verwenden können, sind: location, resourceType, name, resourceGroup, identity/principalId, plan, 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'

Sie können substringof(value, property) im Filter verwenden. Die Eigenschaften, die Sie für eine Teilzeichenfolge verwenden können, sind name und resourceGroup.

Um beispielsweise alle Ressourcen mit "demo" an einer beliebigen Stelle im Namen abzurufen, verwenden Sie: $filter=substringof('demo', name)

Sie können mehrere Teilzeichenfolgen miteinander verknüpfen, indem Sie und/oder Operatoren hinzufügen.

Sie können nach Tagnamen und -werten filtern. Um beispielsweise nach einem Tagnamen und -wert zu filtern, verwenden Sie $filter=tagName eq 'tag1' und tagValue eq 'Value1'. Wenn Sie nach einem Tagnamen und -wert filtern, werden die Tags für jede Ressource nicht in den Ergebnissen zurückgegeben.

Sie können beim Filtern einige Eigenschaften zusammen verwenden. Die Kombinationen, die Sie verwenden können, sind Substringof und/oder resourceType, Plan und Plan/Herausgeber sowie Plan/Name, Identität und Identität/principalId.

$top
query

integer

int32

Die Anzahl der zurückgegebenen Ergebnisse. Wenn NULL übergeben wird, werden alle Ressourcen zurückgegeben.

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