Partilhar via


Resources - List By Resource Group

Obtenha todos os recursos de um grupo de recursos.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O grupo de recursos com os recursos a obter.

Padrão Regex: ^[-\w\._\(\)]+$

subscriptionId
path True

string

O ID da subscrição do Microsoft Azure.

api-version
query True

string

A versão da API a utilizar para esta operação.

$expand
query

string

Lista separada por vírgulas de propriedades adicionais a incluir na resposta. Os valores válidos incluem createdTimee changedTimeprovisioningState. Por exemplo, $expand=createdTime,changedTime.

$filter
query

string

O filtro a aplicar na operação.

As propriedades que pode utilizar para eq (igual a) ou ne (não igual) são: localização, resourceType, nome, resourceGroup, identidade, identidade/principalId, plano, plano/publicador, plano/produto, plano/nome, plano/versão e plano/promotionCode.

Por exemplo, para filtrar por um tipo de recurso, utilize: $filter=resourceType eq "Microsoft.Network/virtualNetworks"

Pode utilizar subcadeia(valor, propriedade) no filtro. As propriedades que pode utilizar para subcadeia são: nome e resourceGroup.

Por exemplo, para obter todos os recursos com "demonstração" em qualquer lugar no nome, utilize: $filter=subcadeia('demonstração', nome)

Pode ligar mais do que uma subcadeia ao adicionar e/ou operadores.

Pode filtrar por nomes de etiquetas e valores. Por exemplo, para filtrar um nome e valor de etiqueta, utilize $filter=tagName eq 'tag1' e tagValue eq 'Value1'. Quando filtra por um nome e valor de etiqueta, as etiquetas para cada recurso não são devolvidas nos resultados.

Pode utilizar algumas propriedades em conjunto ao filtrar. As combinações que pode utilizar são: subcadeia e/ou resourceType, plano e plano/publicador e plano/nome, identidade e identidade/principalId.

$top
query

integer

int32

O número de resultados a devolver. Se for transmitido nulo, devolve todos os recursos.

Respostas

Name Tipo Description
200 OK

ResourceListResult

OK - Devolve uma matriz de recursos

Other Status Codes

CloudError

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Definições

Name Description
CloudError

Uma resposta de erro para um pedido de gestão de recursos.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorResponse

Resposta a Erros

ExtendedLocation

Localização expandida do recurso.

ExtendedLocationType

O tipo de localização expandida.

GenericResourceExpanded

Informações de recursos.

Identity

Identidade do recurso.

Plan

Planeie o recurso.

ResourceIdentityType

O tipo de identidade.

ResourceListResult

Lista de grupos de recursos.

Sku

SKU para o recurso.

UserAssignedIdentities

A lista de identidades de utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

CloudError

Uma resposta de erro para um pedido de gestão de recursos.

Name Tipo Description
error

ErrorResponse

Resposta a Erros
Resposta de erro comum para todas as APIs Resource Manager do Azure para devolver detalhes de erro para operações falhadas. (Isto também segue o formato de resposta a erros OData.)

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorResponse

Resposta a Erros

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorResponse[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ExtendedLocation

Localização expandida do recurso.

Name Tipo Description
name

string

O nome da localização expandida.

type

ExtendedLocationType

O tipo de localização expandida.

ExtendedLocationType

O tipo de localização expandida.

Name Tipo Description
EdgeZone

string

GenericResourceExpanded

Informações de recursos.

Name Tipo Description
changedTime

string

A hora alterada do recurso. Isto só está presente se solicitado através do parâmetro de consulta $expand.

createdTime

string

A hora de criação do recurso. Isto só está presente se solicitado através do parâmetro de consulta $expand.

extendedLocation

ExtendedLocation

Localização expandida do recurso.

id

string

ID do Recurso

identity

Identity

A identidade do recurso.

kind

string

O tipo de recurso.

location

string

Localização do recurso

managedBy

string

ID do recurso que gere este recurso.

name

string

Nome do recurso

plan

Plan

O plano do recurso.

properties

object

As propriedades do recurso.

provisioningState

string

O estado de aprovisionamento do recurso. Isto só está presente se solicitado através do parâmetro de consulta $expand.

sku

Sku

O SKU do recurso.

tags

object

Etiquetas de recursos

type

string

Tipo de recurso

Identity

Identidade do recurso.

Name Tipo Description
principalId

string

O ID principal da identidade de recurso.

tenantId

string

O ID do inquilino do recurso.

type

ResourceIdentityType

O tipo de identidade.

userAssignedIdentities

UserAssignedIdentities

A lista de identidades de utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Plan

Planeie o recurso.

Name Tipo Description
name

string

O ID do plano.

product

string

O ID da oferta.

promotionCode

string

O código de promoção.

publisher

string

O ID do editor.

version

string

A versão do plano.

ResourceIdentityType

O tipo de identidade.

Name Tipo Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

ResourceListResult

Lista de grupos de recursos.

Name Tipo Description
nextLink

string

O URL a utilizar para obter o próximo conjunto de resultados.

value

GenericResourceExpanded[]

Uma matriz de recursos.

Sku

SKU para o recurso.

Name Tipo Description
capacity

integer

A capacidade de SKU.

family

string

A família SKU.

model

string

O modelo de SKU.

name

string

O nome do SKU.

size

string

O tamanho do SKU.

tier

string

O escalão SKU.

UserAssignedIdentities

A lista de identidades de utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Name Tipo Description