Condividi tramite


Resources - List By Resource Group

Ottenere tutte le risorse per un gruppo di risorse.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Gruppo di risorse con le risorse da ottenere.

Criterio di espressione regolare: ^[-\w\._\(\)]+$

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.

Le proprietà che è possibile usare per eq (uguale) o ne (non uguali) sono: posizione, resourceType, nome, resourceGroup, identità, identity/principalId, piano, piano/server di pubblicazione, piano/prodotto, piano/nome, piano/versione e plan/promotionCode.

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

È possibile usare sottostringof(value, property) nel filtro. Le proprietà che è possibile usare per la sottostringa sono: nome e resourceGroup.

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

È possibile collegare più sottostringa insieme aggiungendo e/o operatori.

È possibile filtrare in base ai nomi e ai valori dei tag. Ad esempio, per filtrare un nome e un valore di tag, usare $filter=tagName eq 'tag1' e tagValue eq 'Value1'. Quando si filtra in base al nome e al valore di un tag, i tag per ogni risorsa non vengono restituiti nei risultati.

È possibile usare alcune proprietà insieme durante il filtro. Le combinazioni che è possibile usare sono: substringof e/o resourceType, piano e piano/editore e piano/nome, identità e identità/principalId.

$top
query

integer

int32

Numero di risultati da restituire. Se viene passato null, restituisce tutte le risorse.

Risposte

Nome Tipo Descrizione
200 OK

ResourceListResult

OK - Restituisce una matrice di risorse

Other Status Codes

CloudError

Risposta di errore che descrive perché l'operazione non è riuscita.

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

Definizioni

Nome Descrizione
CloudError

Risposta di errore per una richiesta di gestione delle risorse.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorResponse

Risposta di errore

ExtendedLocation

Percorso esteso delle risorse.

ExtendedLocationType

Tipo di percorso esteso.

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 delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel modulo: '/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 di Resource Manager di Azure per restituire i dettagli degli errori per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

ErrorAdditionalInfo

Informazioni aggiuntive sulla 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

Percorso esteso delle risorse.

Nome Tipo Descrizione
name

string

Nome percorso esteso.

type

ExtendedLocationType

Tipo di percorso esteso.

ExtendedLocationType

Tipo di percorso esteso.

Nome Tipo Descrizione
EdgeZone

string

GenericResourceExpanded

Informazioni sulla risorsa.

Nome Tipo Descrizione
changedTime

string

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

createdTime

string

Ora creata della risorsa. Questa operazione è presente solo se richiesta tramite il parametro di query $expand.

extendedLocation

ExtendedLocation

Percorso esteso 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 operazione è presente solo se richiesta 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 delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel modulo: '/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 successivo di risultati.

value

GenericResourceExpanded[]

Matrice di risorse.

Sku

SKU per la risorsa.

Nome Tipo Descrizione
capacity

integer

Capacità SKU.

family

string

Famiglia sku.

model

string

Modello SKU.

name

string

Nome SKU.

size

string

Dimensioni dello SKU.

tier

string

Livello SKU.

UserAssignedIdentities

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

Nome Tipo Descrizione