Labs - List

Serviço:

Education

Versão da API:

2021-12-01-preview

Obtenha os detalhes de um laboratório específico associado ao nome da conta de cobrança fornecido, ao nome do perfil de cobrança e ao nome da seção da fatura.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs?api-version=2021-12-01-preview

Com parâmetros opcionais:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs?api-version=2021-12-01-preview&includeBudget={includeBudget}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
billingAccountName	path	True	string	O nome da conta de cobrança.
billingProfileName	path	True	string	O nome do perfil de cobrança.
invoiceSectionName	path	True	string	O nome da seção da fatura.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.
includeBudget	query		boolean	Pode ser usado para incluir informações de orçamento.

Respostas

Nome	Tipo	Description
200 OK	LabListResult	A operação do Azure foi concluída com êxito.
Other Status Codes	ErrorResponseBody	Descreve o erro se a operação não for bem-sucedida.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

LabListWithInvoiceSectionName

LabListWithInvoiceSectionNameIncludeBudget

LabListWithInvoiceSectionName

Solicitação de exemplo

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs?api-version=2021-12-01-preview&includeBudget=True

Resposta de exemplo

Código de status:

200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default",
      "name": "default",
      "type": "Microsoft.Education/Labs",
      "properties": {
        "displayName": "example lab",
        "budgetPerStudent": {
          "currency": "USD",
          "value": 100
        },
        "description": "example lab description",
        "expirationDate": "2021-12-09T21:25:56.838Z",
        "effectiveDate": "2021-11-09T21:25:56.838Z",
        "status": "Active",
        "totalBudget": {
          "currency": "USD",
          "value": 500
        },
        "totalAllocatedBudget": {
          "currency": "USD",
          "value": 500
        }
      }
    }
  ]
}

LabListWithInvoiceSectionNameIncludeBudget

Solicitação de exemplo

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs?api-version=2021-12-01-preview&includeBudget=True

Resposta de exemplo

Código de status:

200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default",
      "name": "default",
      "type": "Microsoft.Education/Labs",
      "properties": {
        "displayName": "example lab",
        "budgetPerStudent": {
          "currency": "USD",
          "value": 100
        },
        "description": "example lab description",
        "expirationDate": "2021-12-09T21:25:56.838Z",
        "effectiveDate": "2021-11-09T21:25:56.838Z",
        "status": "Active",
        "totalBudget": {
          "currency": "USD",
          "value": 500
        },
        "totalAllocatedBudget": {
          "currency": "USD",
          "value": 500
        }
      }
    }
  ]
}

Definições

Nome	Description
Amount	O valor.
createdByType	O tipo de identidade que criou o recurso.
ErrorResponse	Descreve o formato da resposta de erro.
ErrorResponseBody	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.
LabDetails	Detalhes do laboratório.
LabListResult	Lista de informações sobre os laboratórios.
LabStatus	O status deste laboratório
systemData	Metadados relativos à criação e última modificação do recurso.

Amount

Objeto

O valor.

Nome	Tipo	Description
currency	string	O tipo de moeda que está sendo usada para o valor.
value	number (float)	Valor da quantidade.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Objeto

Descreve o formato da resposta de erro.

Nome	Tipo	Description
code	string	Código de erro
message	string	Mensagem de erro indicando por que a operação falhou.

ErrorResponseBody

Objeto

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Nome	Tipo	Description
error	ErrorResponse	Os detalhes do erro.

LabDetails

Objeto

Detalhes do laboratório.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties.budgetPerStudent	Amount	Limite monetário padrão para cada aluno neste laboratório
properties.description	string	Descrição detalhada deste laboratório
properties.displayName	string	Nome de exibição do laboratório
properties.effectiveDate	string (date-time)	Data de criação do laboratório
properties.expirationDate	string (date-time)	Data de validade padrão para cada aluno neste laboratório
properties.invitationCode	string	código de convite para o laboratório resgatável
properties.maxStudentCount	number (float)	o número total de alunos que podem ser aceitos no laboratório.
properties.status	LabStatus	O status deste laboratório
properties.totalAllocatedBudget.currency	string	O tipo de moeda que está sendo usada para o valor.
properties.totalAllocatedBudget.value	number (float)	Valor da quantidade.
properties.totalBudget.currency	string	O tipo de moeda que está sendo usada para o valor.
properties.totalBudget.value	number (float)	Valor da quantidade.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

LabListResult

Objeto

Lista de informações sobre os laboratórios.

Nome	Tipo	Description
nextLink	string	O link para a próxima página de itens.
value	LabDetails[]	Os itens LabDetails nesta página.

LabStatus

Enumeração

O status deste laboratório

Valor	Description
Active	Ativo
Deleted	Excluído
Pending	Pendente

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.