Resources - List

Obtenez toutes les ressources d’un abonnement.

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

Paramètres URI

Nom Dans Obligatoire Type Description
subscriptionId
path True

string

ID d’abonnement Microsoft Azure.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

$expand
query

string

Liste séparée par des virgules des propriétés supplémentaires à inclure dans la réponse. Les valeurs valides incluent createdTime, changedTime et provisioningState. Par exemple : $expand=createdTime,changedTime.

$filter
query

string

Filtre à appliquer à l’opération.

Les opérateurs de comparaison de filtre incluent eq (est égal) et ne (non égal) et peuvent être utilisés avec les propriétés suivantes : location, , identityidentity/principalIdresourceGroupnameplan/publisherplanresourceType, , plan/nameplan/productplan/version, et .plan/promotionCode

Par exemple, pour filtrer par type de ressource, utilisez $filter=resourceType eq 'Microsoft.Network/virtualNetworks'


substringof(value, property) peut être utilisé pour filtrer les sous-chaînes des propriétés actuellement prises en charge suivantes : name et resourceGroup

Par exemple, pour obtenir toutes les ressources avec « demo » n’importe où dans le nom de la ressource, utilisez $filter=substringof('demo', name)

Plusieurs opérations de sous-chaîne peuvent également être combinées à l’aide d’opérateurs and/or .

Notez que tout nombre tronqué de résultats interrogés via $top peut également ne pas être compatible lors de l’utilisation d’un filtre.


Les ressources peuvent être filtrées par noms et valeurs de balise. Par exemple, pour filtrer le nom et la valeur d’une balise, utilisez $filter=tagName eq 'tag1' and tagValue eq 'Value1'. Notez que lorsque les ressources sont filtrées par nom et valeur de balise, les balises d’origine de chaque ressource ne sont pas retournées dans les résultats. Toute liste de propriétés supplémentaires interrogées par le biais $expand peut également ne pas être compatible lors du filtrage par noms/valeurs de balise.

Pour les noms de balise uniquement, les ressources peuvent être filtrées par préfixe à l’aide de la syntaxe suivante : $filter=startswith(tagName, 'depart'). Cette requête retourne toutes les ressources avec un nom de balise préfixé par l’expression depart (par exempledepartment, departureDate, departureTime, etc.)


Notez que certaines propriétés peuvent être combinées lors du filtrage des ressources, notamment : substringof() and/or resourceType, plan and plan/publisher and plan/nameet identity and identity/principalId.

$top
query

integer

int32

Nombre de recommandations par page si une version paginée de cette API est utilisée.

Réponses

Nom Type Description
200 OK

ResourceListResult

OK : retourne un tableau de ressources.

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Définitions

Nom Description
CloudError

Réponse d’erreur pour une demande de gestion des ressources.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorResponse

Réponse d’erreur

ExtendedLocation

Emplacement étendu des ressources.

ExtendedLocationType

Type d’emplacement étendu.

GenericResourceExpanded

Informations sur la ressource.

Identity

Identité de la ressource.

Plan

Plan de la ressource.

ResourceIdentityType

Type d’identité.

ResourceListResult

Liste des groupes de ressources.

Sku

Référence SKU pour la ressource.

UserAssignedIdentities

Liste des identités d’utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

CloudError

Réponse d’erreur pour une demande de gestion des ressources.

Nom Type Description
error

ErrorResponse

Réponse d’erreur
Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.)

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorResponse

Réponse d’erreur

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorResponse[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ExtendedLocation

Emplacement étendu des ressources.

Nom Type Description
name

string

Nom de l’emplacement étendu.

type

ExtendedLocationType

Type d’emplacement étendu.

ExtendedLocationType

Type d’emplacement étendu.

Nom Type Description
EdgeZone

string

GenericResourceExpanded

Informations sur la ressource.

Nom Type Description
changedTime

string

Heure modifiée de la ressource. Cette option est uniquement présente si elle est demandée via le paramètre de requête $expand.

createdTime

string

Heure de création de la ressource. Cette option est uniquement présente si elle est demandée via le paramètre de requête $expand.

extendedLocation

ExtendedLocation

Emplacement étendu des ressources.

id

string

ID de ressource

identity

Identity

Identité de la ressource.

kind

string

Type de ressource.

location

string

Emplacement de la ressource

managedBy

string

ID de la ressource qui gère cette ressource.

name

string

Nom de la ressource

plan

Plan

Plan de la ressource.

properties

object

Propriétés de la ressource.

provisioningState

string

État d’approvisionnement de la ressource. Cette option est uniquement présente si elle est demandée via le paramètre de requête $expand.

sku

Sku

Référence SKU de la ressource.

tags

object

Balises de ressource

type

string

Type de ressource

Identity

Identité de la ressource.

Nom Type Description
principalId

string

ID principal de l’identité de ressource.

tenantId

string

ID de locataire de la ressource.

type

ResourceIdentityType

Type d’identité.

userAssignedIdentities

UserAssignedIdentities

Liste des identités d’utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

Plan

Plan de la ressource.

Nom Type Description
name

string

ID de plan.

product

string

ID de l’offre.

promotionCode

string

Code promotionnel.

publisher

string

ID de l’éditeur.

version

string

Version du plan.

ResourceIdentityType

Type d’identité.

Nom Type Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

ResourceListResult

Liste des groupes de ressources.

Nom Type Description
nextLink

string

URL à utiliser pour obtenir l’ensemble de résultats suivant.

value

GenericResourceExpanded[]

Tableau de ressources.

Sku

Référence SKU pour la ressource.

Nom Type Description
capacity

integer

Capacité de référence SKU.

family

string

Famille de références SKU.

model

string

Modèle de référence SKU.

name

string

Le nom du SKU.

size

string

Taille de la référence SKU.

tier

string

Niveau de référence SKU.

UserAssignedIdentities

Liste des identités d’utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

Nom Type Description