Marketplaces By Billing Account - List

Serviço:

Consumption

Versão da API:

2018-03-31

Lista os marketplaces para um escopo cobrandoAccountId e o período de cobrança atual. Os marketplaces estão disponíveis por meio dessa API somente para 1º de maio de 2014 ou posterior.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/marketplaces?api-version=2018-03-31

Com parâmetros opcionais:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/marketplaces?$filter={$filter}&$top={$top}&$skiptoken={$skiptoken}&api-version=2018-03-31

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	Versão da API a ser usada com a solicitação do cliente. A versão atual é 2018-03-31.
$filter	query		string	Pode ser usado para filtrar marketplaces por properties/usageEnd (hora utc), properties/usageStart (hora utc), properties/resourceGroup, properties/instanceName ou properties/instanceId. O filtro dá suporte a 'eq', 'lt', 'gt', 'le', 'ge' e 'and'. Atualmente, ele não dá suporte a 'ne', 'or' ou 'not'.
$skiptoken	query		string	Skiptoken só será usado se uma operação anterior retornar um resultado parcial. Se uma resposta anterior contiver um elemento nextLink, o valor do elemento nextLink incluirá um parâmetro skiptoken que especifica um ponto de partida a ser usado para chamadas subsequentes.
$top	query		integer minimum: 1 maximum: 1000	Pode ser usado para limitar o número de resultados aos N marketplaces mais recentes.

Respostas

Nome	Tipo	Description
200 OK	MarketplacesListResult	OKEY. A solicitação foi bem-sucedida.
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

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

MarketplacesList

Solicitação de exemplo

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/marketplaces?api-version=2018-03-31

Resposta de exemplo

Código de status:

200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/marketplaces/marketplaceId1",
      "name": "marketplaceId1",
      "type": "Microsoft.Consumption/marketPlaces",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Billing/billingPeriods/201702",
        "usageStart": "2017-02-13T00:00:00Z",
        "usageEnd": "2017-02-13T23:59:59Z",
        "instanceName": "shared1",
        "instanceId": "/subscriptions/subid/resourceGroups/Default-Web-eastasia/providers/Microsoft.Web/sites/shared1",
        "currency": "USD",
        "consumedQuantity": 0.00328,
        "pretaxCost": 0.67,
        "isEstimated": false,
        "offerName": "offer1",
        "resourceGroup": "TEST",
        "orderNumber": "00000000-0000-0000-0000-000000000000",
        "publisherName": "xyz",
        "planName": "plan1",
        "resourceRate": 0.24,
        "subscriptionGuid": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "azure subscription"
      }
    }
  ]
}

Definições

Nome	Description
ErrorDetails	Os detalhes do erro.
ErrorResponse	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.
Marketplace	Um recurso do marketplace.
MarketplacesListResult	Resultado da listagem de marketplaces. Ele contém uma lista de marketplaces disponíveis em ordem cronológica inversa por período de cobrança.

ErrorDetails

Objeto

Os detalhes do erro.

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

ErrorResponse

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	ErrorDetails	Os detalhes do erro.

Marketplace

Objeto

Um recurso do marketplace.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.accountName	string	Nome da conta.
properties.additionalProperties	string	Detalhes adicionais desse item de uso. Por padrão, isso não é preenchido, a menos que seja especificado em $expand.
properties.billingPeriodId	string	A ID do recurso de período de cobrança ao qual o uso pertence.
properties.consumedQuantity	number (decimal)	A quantidade de uso.
properties.consumedService	string	Nome do serviço consumido.
properties.costCenter	string	O centro de custo deste departamento se for um departamento e um costcenter existir
properties.currency	string	A moeda ISO na qual o medidor é cobrado, por exemplo, USD.
properties.departmentName	string	Nome do departamento.
properties.instanceId	string	O uri da instância de recurso sobre a qual se trata o uso.
properties.instanceName	string	O nome da instância de recurso sobre a qual se trata o uso.
properties.isEstimated	boolean	O uso estimado está sujeito a alterações.
properties.meterId	string (uuid)	A ID do medidor (GUID).
properties.offerName	string	O tipo de oferta.
properties.orderNumber	string	O número da ordem.
properties.planName	string	O nome do plano.
properties.pretaxCost	number (decimal)	A quantidade de custo antes do imposto.
properties.publisherName	string	O nome do editor.
properties.resourceGroup	string	O nome do grupo de recursos.
properties.resourceRate	number (decimal)	A taxa de recursos do marketplace.
properties.subscriptionGuid	string (uuid)	Guid de assinatura.
properties.subscriptionName	string	Nome da assinatura.
properties.unitOfMeasure	string	A unidade de medida.
properties.usageEnd	string (date-time)	O fim do intervalo de data/hora coberto pelos detalhes de uso.
properties.usageStart	string (date-time)	O início do intervalo de data/hora coberto pelos detalhes de uso.
tags	object	Marcas de recurso.
type	string	Tipo de recurso.

MarketplacesListResult

Objeto

Resultado da listagem de marketplaces. Ele contém uma lista de marketplaces disponíveis em ordem cronológica inversa por período de cobrança.

Nome	Tipo	Description
nextLink	string	O link (url) para a próxima página de resultados.
value	Marketplace[]	A lista de marketplaces.