Resources - List

Ottenere tutte le risorse in una sottoscrizione.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
subscriptionId
path True

string

ID sottoscrizione di Microsoft Azure.

api-version
query True

string

Versione dell'API da usare per questa operazione.

$expand
query

string

Elenco delimitato da virgole di proprietà aggiuntive da includere nella risposta. I valori validi includono createdTime, changedTime e provisioningState. Ad esempio: $expand=createdTime,changedTime.

$filter
query

string

Filtro da applicare all'operazione.

Gli operatori di confronto dei filtri includono eq (uguali) e ne (non uguali) e possono essere usati con le proprietà seguenti: location, resourceType, resourceGroupname, , identity/principalIdidentity, plan/publisherplan/productplan/nameplanplan/versione .plan/promotionCode

Ad esempio, per filtrare in base a un tipo di risorsa, usare $filter=resourceType eq 'Microsoft.Network/virtualNetworks'


substringof(value, property) può essere usato per filtrare le sottostringhe delle proprietà attualmente supportate seguenti: name e resourceGroup

Ad esempio, per ottenere tutte le risorse con "demo" ovunque nel nome della risorsa, usare $filter=substringof('demo', name)

È anche possibile combinare più operazioni di sottostringa usando and/or gli operatori.

Si noti che qualsiasi numero troncato di risultati sottoposti a query tramite $top potrebbe anche non essere compatibile quando si usa un filtro.


Le risorse possono essere filtrate in base ai nomi e ai valori dei tag. Ad esempio, per filtrare il nome e il valore di un tag, usare $filter=tagName eq 'tag1' and tagValue eq 'Value1'. Si noti che quando le risorse vengono filtrate in base al nome e al valore del tag, i tag originali per ogni risorsa non verranno restituiti nei risultati. Qualsiasi elenco di proprietà aggiuntive sottoposte a query tramite $expand potrebbe anche non essere compatibile quando si filtrano in base a nomi/valori di tag.

Solo per i nomi di tag, le risorse possono essere filtrate in base al prefisso usando la sintassi seguente: $filter=startswith(tagName, 'depart'). Questa query restituirà tutte le risorse con un nome di tag preceduto dalla frase depart ,departureDatead esempiodepartment , , departureTimee così via.


Si noti che alcune proprietà possono essere combinate durante il filtro delle risorse, che includono quanto segue: substringof() and/or resourceType, plan and plan/publisher and plan/namee identity and identity/principalId.

$top
query

integer

int32

Numero di raccomandazioni per pagina se viene usata una versione di paging di questa API.

Risposte

Nome Tipo Descrizione
200 OK

ResourceListResult

OK: restituisce una matrice di risorse.

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

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

Definizioni

Nome Descrizione
CloudError

Risposta di errore per una richiesta di gestione delle risorse.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorResponse

Risposta di errore

ExtendedLocation

Posizione estesa delle risorse.

ExtendedLocationType

Tipo di posizione estesa.

GenericResourceExpanded

Informazioni sulla risorsa.

Identity

Identità per la risorsa.

Plan

Piano per la risorsa.

ResourceIdentityType

Tipo di identità.

ResourceListResult

Elenco di gruppi di risorse.

Sku

SKU per la risorsa.

UserAssignedIdentities

Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

CloudError

Risposta di errore per una richiesta di gestione delle risorse.

Nome Tipo Descrizione
error

ErrorResponse

Risposta di errore
Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorResponse[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ExtendedLocation

Posizione estesa delle risorse.

Nome Tipo Descrizione
name

string

Nome della posizione estesa.

type

ExtendedLocationType

Tipo di posizione estesa.

ExtendedLocationType

Tipo di posizione estesa.

Nome Tipo Descrizione
EdgeZone

string

GenericResourceExpanded

Informazioni sulla risorsa.

Nome Tipo Descrizione
changedTime

string

Ora modificata della risorsa. Questa opzione è presente solo se richiesto tramite il parametro di query $expand.

createdTime

string

Ora di creazione della risorsa. Questa opzione è presente solo se richiesto tramite il parametro di query $expand.

extendedLocation

ExtendedLocation

Posizione estesa delle risorse.

id

string

ID risorsa

identity

Identity

Identità della risorsa.

kind

string

Tipo di risorsa.

location

string

Posizione risorsa

managedBy

string

ID della risorsa che gestisce questa risorsa.

name

string

Nome risorsa

plan

Plan

Piano della risorsa.

properties

object

Proprietà della risorsa.

provisioningState

string

Stato di provisioning della risorsa. Questa opzione è presente solo se richiesto tramite il parametro di query $expand.

sku

Sku

SKU della risorsa.

tags

object

Tag delle risorse

type

string

Tipo di risorsa

Identity

Identità per la risorsa.

Nome Tipo Descrizione
principalId

string

ID principale dell'identità della risorsa.

tenantId

string

ID tenant della risorsa.

type

ResourceIdentityType

Tipo di identità.

userAssignedIdentities

UserAssignedIdentities

Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Plan

Piano per la risorsa.

Nome Tipo Descrizione
name

string

ID piano.

product

string

ID offerta.

promotionCode

string

Codice promozione.

publisher

string

ID editore.

version

string

Versione del piano.

ResourceIdentityType

Tipo di identità.

Nome Tipo Descrizione
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

ResourceListResult

Elenco di gruppi di risorse.

Nome Tipo Descrizione
nextLink

string

URL da usare per ottenere il set di risultati successivo.

value

GenericResourceExpanded[]

Matrice di risorse.

Sku

SKU per la risorsa.

Nome Tipo Descrizione
capacity

integer

Capacità SKU.

family

string

Famiglia di SKU.

model

string

Modello SKU.

name

string

Nome DELLO SKU.

size

string

Dimensioni dello SKU.

tier

string

Livello SKU.

UserAssignedIdentities

Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Nome Tipo Descrizione