Share 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 de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

O grupo de recursos com os recursos a serem obtidos.

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

subscriptionId
path True

string

A ID da assinatura do Microsoft Azure.

api-version
query True

string

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

$expand
query

string

Lista separada por vírgulas de propriedades adicionais a serem incluídas na resposta. Os valores válidos incluem createdTime, changedTime e provisioningState. Por exemplo, $expand=createdTime,changedTime.

$filter
query

string

O filtro a ser aplicado na operação.

As propriedades que você pode usar para eq (igual a) ou ne (não é igual a) são: location, resourceType, name, resourceGroup, identity, identity/principalId, plan, plan/publisher, plan/product, plan/name, plan/version e plan/promotionCode.

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

Você pode usar substringof(value, property) no filtro. As propriedades que você pode usar para subcadeia de caracteres são: name e resourceGroup.

Por exemplo, para obter todos os recursos com 'demonstração' em qualquer lugar no nome, use: $filter=substringof('demo', name)

Você pode vincular mais de uma substringof adicionando operadores e/ou .

Você pode filtrar por nomes e valores de marca. Por exemplo, para filtrar um nome e um valor de marca, use $filter=tagName eq 'tag1' e tagValue eq 'Value1'. Quando você filtra por um nome de marca e valor, as marcas de cada recurso não são retornadas nos resultados.

Você pode usar algumas propriedades juntas ao filtrar. As combinações que você pode usar são: substringof e/ou resourceType, plan e plan/publisher e plan/name, identity e identity/principalId.

$top
query

integer

int32

O número de resultados a serem retornados. Se nulo for passado, retornará todos os recursos.

Respostas

Nome Tipo Description
200 OK

ResourceListResult

OK – retorna uma matriz de recursos

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Definições

Nome Description
CloudError

Uma resposta de erro para uma solicitação de gerenciamento de recursos.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorResponse

Resposta de erro

ExtendedLocation

Local estendido do recurso.

ExtendedLocationType

O tipo de local estendido.

GenericResourceExpanded

Informações sobre o recurso.

Identity

Identidade do recurso.

Plan

Planejar para o recurso.

ResourceIdentityType

O tipo de identidade.

ResourceListResult

Lista de grupos de recursos.

Sku

SKU para o recurso.

UserAssignedIdentities

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

CloudError

Uma resposta de erro para uma solicitação de gerenciamento de recursos.

Nome Tipo Description
error

ErrorResponse

Resposta de erro
Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro de operações com falha. (Isso também segue o formato de resposta de erro OData.)

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorResponse

Resposta de erro

Nome 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

Local estendido do recurso.

Nome Tipo Description
name

string

O nome do local estendido.

type

ExtendedLocationType

O tipo de local estendido.

ExtendedLocationType

O tipo de local estendido.

Nome Tipo Description
EdgeZone

string

GenericResourceExpanded

Informações sobre o recurso.

Nome Tipo Description
changedTime

string

A hora alterada do recurso. Isso só estará presente se solicitado por meio do parâmetro de consulta $expand.

createdTime

string

A hora criada do recurso. Isso só estará presente se solicitado por meio do parâmetro de consulta $expand.

extendedLocation

ExtendedLocation

Local estendido do recurso.

id

string

ID de Recurso

identity

Identity

A identidade do recurso.

kind

string

O tipo do recurso.

location

string

Localização do recurso

managedBy

string

ID do recurso que gerencia esse recurso.

name

string

Nome do recurso

plan

Plan

O plano do recurso.

properties

object

As propriedades do recurso.

provisioningState

string

O estado de provisionamento do recurso. Isso só estará presente se solicitado por meio do parâmetro de consulta $expand.

sku

Sku

A SKU do recurso.

tags

object

Marcações de recursos

type

string

Tipo de recurso

Identity

Identidade do recurso.

Nome Tipo Description
principalId

string

A ID da entidade de segurança da identidade do recurso.

tenantId

string

A ID do locatário do recurso.

type

ResourceIdentityType

O tipo de identidade.

userAssignedIdentities

UserAssignedIdentities

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

Plan

Planejar para o recurso.

Nome Tipo Description
name

string

A ID do plano.

product

string

A ID da oferta.

promotionCode

string

O código da promoção.

publisher

string

A ID do editor.

version

string

A versão do plano.

ResourceIdentityType

O tipo de identidade.

Nome Tipo Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

ResourceListResult

Lista de grupos de recursos.

Nome Tipo Description
nextLink

string

A URL a ser usada para obter o próximo conjunto de resultados.

value

GenericResourceExpanded[]

Uma matriz de recursos.

Sku

SKU para o recurso.

Nome Tipo Description
capacity

integer

A capacidade do SKU.

family

string

A família SKU.

model

string

O modelo de SKU.

name

string

Nome do SKU.

size

string

O tamanho do SKU.

tier

string

A camada da SKU.

UserAssignedIdentities

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

Nome Tipo Description