Share via


Resource Groups - List

Obtém todos os grupos de recursos de uma subscrição.

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

Parâmetros do URI

Name Em Necessário Tipo Description
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.

$filter
query

string

O filtro a aplicar na operação.

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'

$top
query

integer

int32

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

Respostas

Name Tipo Description
200 OK

ResourceGroupListResult

OK - Devolve uma matriz de grupos 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

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

Scopes

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

ResourceGroup

Informações do grupo de recursos.

ResourceGroupListResult

Lista de grupos de recursos.

ResourceGroupProperties

As propriedades do grupo de recursos.

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.

ResourceGroup

Informações do grupo de recursos.

Name Tipo Description
id

string

O ID do grupo de recursos.

location

string

A localização do grupo de recursos. Não é possível alterá-la depois de o grupo de recursos ter sido criado. Tem de ser uma das localizações suportadas do Azure.

managedBy

string

O ID do recurso que gere este grupo de recursos.

name

string

O nome do grupo de recursos.

properties

ResourceGroupProperties

As propriedades do grupo de recursos.

tags

object

As etiquetas anexadas ao grupo de recursos.

type

string

O tipo do grupo de recursos.

ResourceGroupListResult

Lista de grupos de recursos.

Name Tipo Description
nextLink

string

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

value

ResourceGroup[]

Uma matriz de grupos de recursos.

ResourceGroupProperties

As propriedades do grupo de recursos.

Name Tipo Description
provisioningState

string

O estado de aprovisionamento.