Partilhar via


Subscriptions - Get

Obtém detalhes sobre uma subscrição especificada.

GET https://management.azure.com/subscriptions/{subscriptionId}?api-version=2022-12-01

Parâmetros do URI

Name Em Necessário Tipo Description
subscriptionId
path True

string

O ID da subscrição de destino.

api-version
query True

string

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

Respostas

Name Tipo Description
200 OK

Subscription

OK - Devolve informações sobre a subscrição.

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

Exemplos

GetASingleSubscription

Pedido de amostra

GET https://management.azure.com/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05?api-version=2022-12-01

Resposta da amostra

{
  "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
  "subscriptionId": "291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
  "tenantId": "31c75423-32d6-4322-88b7-c478bdde4858",
  "displayName": "Example Subscription",
  "state": "Enabled",
  "subscriptionPolicies": {
    "locationPlacementId": "Internal_2014-09-01",
    "quotaId": "Internal_2014-09-01",
    "spendingLimit": "Off"
  },
  "authorizationSource": "Bypassed",
  "managedByTenants": [
    {
      "tenantId": "8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"
    }
  ],
  "tags": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  }
}

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.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

ManagedByTenant

Informações sobre um inquilino que gere a subscrição.

spendingLimit

O limite de gastos da subscrição.

Subscription

Informações da subscrição.

SubscriptionPolicies

Políticas de subscrição.

SubscriptionState

O estado da subscrição. Os valores possíveis estão Ativados, Avisados, PastDue, Desativados e Eliminados.

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 de erro 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.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ManagedByTenant

Informações sobre um inquilino que gere a subscrição.

Name Tipo Description
tenantId

string

O ID do inquilino de gestão. Este é um GUID.

spendingLimit

O limite de gastos da subscrição.

Name Tipo Description
CurrentPeriodOff

string

Off

string

On

string

Subscription

Informações da subscrição.

Name Tipo Description
authorizationSource

string

A origem de autorização do pedido. Os valores válidos são uma ou mais combinações de Legado, RoleBased, Bypassed, Direct e Management. Por exemplo, "Legado, RoleBased".

displayName

string

O nome a apresentar da subscrição.

id

string

O ID completamente qualificado da subscrição. Por exemplo, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74

managedByTenants

ManagedByTenant[]

Uma matriz que contém os inquilinos que gerem a subscrição.

state

SubscriptionState

O estado da subscrição. Os valores possíveis estão Ativados, Avisados, PastDue, Desativados e Eliminados.

subscriptionId

string

O ID da subscrição.

subscriptionPolicies

SubscriptionPolicies

As políticas de subscrição.

tags

object

As etiquetas anexadas à subscrição.

tenantId

string

O ID do inquilino da subscrição.

SubscriptionPolicies

Políticas de subscrição.

Name Tipo Description
locationPlacementId

string

O ID de colocação da localização da subscrição. O ID indica que regiões estão visíveis para uma subscrição. Por exemplo, uma subscrição com um ID de colocação de localização do Public_2014-09-01 tem acesso às regiões públicas do Azure.

quotaId

string

O ID da quota da subscrição.

spendingLimit

spendingLimit

O limite de gastos da subscrição.

SubscriptionState

O estado da subscrição. Os valores possíveis estão Ativados, Avisados, PastDue, Desativados e Eliminados.

Name Tipo Description
Deleted

string

Disabled

string

Enabled

string

PastDue

string

Warned

string