Settings - Get

Serviço:

Cost Management

Versão da API:

2019-11-01

Recupera o valor atual de uma configuração específica.

GET https://management.azure.com/providers/Microsoft.CostManagement/settings/{settingName}?api-version=2019-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
settingName	path	True	string maxLength: 32	Nome da configuração. Valores permitidos: myscope
api-version	query	True	string	Versão da API a ser usada com a solicitação do cliente. A versão atual é 2019-11-01.

Respostas

Name	Tipo	Description
200 OK	Setting	OK. O pedido foi bem-sucedido.
Other Status Codes	ErrorResponse	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Settings

Pedido de amostra

HTTP

GET https://management.azure.com/providers/Microsoft.CostManagement/settings/myscope?api-version=2019-11-01

Resposta da amostra

Código de estado:

200

{
  "id": "/providers/Microsoft.CostManagement/settings/myscope",
  "name": "myscope",
  "kind": "user",
  "type": "Microsoft.CostManagement/Settings",
  "properties": {
    "scope": "/subscriptions/00000000-0000-0000-0000-000000000000",
    "startOn": "LastUsed",
    "cache": [
      {
        "id": "/providers/Microsoft.Management/managementGroups/72f988bf-86f1-41af-91ab-2d7cd011db47",
        "name": "72f988bf-86f1-41af-91ab-2d7cd011db47",
        "channel": "Modern",
        "subchannel": "NotApplicable",
        "parent": "/providers/Microsoft.Management/managementGroups/acm",
        "status": "enabled"
      }
    ]
  }
}

Definições

Name	Description
Cache	Matriz de escopos com detalhes adicionais usados pelo Gerenciamento de Custos no portal do Azure.
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. Algumas respostas de erro: 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".
Setting	Estado da configuração myscope.

Cache

Object

Matriz de escopos com detalhes adicionais usados pelo Gerenciamento de Custos no portal do Azure.

Name	Tipo	Description
channel	string	Indica o tipo de conta. Os valores permitidos incluem: EA, PAYG, Moderno, Interno, Desconhecido.
id	string	ID do recurso usado pelo Gerenciador de Recursos para identificar exclusivamente o escopo.
name	string	Nome para exibição do escopo.
parent	string	ID do recurso do escopo pai. Por exemplo, o ID de recurso da assinatura para um grupo de recursos ou um ID de recurso do grupo de gerenciamento para uma assinatura.
status	string	Indica o status do escopo. O estado aplica-se apenas a subscrições e contas de faturação.
subchannel	string	Indica o tipo de conta moderna. Os valores permitidos incluem: Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Object

Os detalhes do erro.

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

ErrorResponse

Object

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.

Algumas respostas de erro:

• 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Name	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

Setting

Object

Estado da configuração myscope.

Name	Tipo	Description
id	string	Id do recurso.
kind	string maxLength: 10	Tipo de recurso.
name	string	Nome do recurso.
properties.cache	Cache[]	Matriz de escopos com detalhes adicionais usados pelo Gerenciamento de Custos no portal do Azure.
properties.scope	string	Define o escopo padrão que o usuário atual verá quando entrar no Gerenciamento de Custos do Azure no portal do Azure.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Indica qual escopo o Gerenciamento de Custos no portal do Azure deve usar como padrão. Valores permitidos: LastUsed.
type	string	Tipo de recurso.