Settings - Get

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

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

Parâmetros de URI

Name In Required Type Description
settingName
path True
  • string

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 Type Description
200 OK

OK. A solicitação foi bem-sucedida.

Other Status Codes

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Azure Active Directory fluxo OAuth2.

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Settings

Sample Request

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

Sample Response

{
  "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

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 é acelerada. Tentar novamente depois de aguardar o tempo especificado no header "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable – o serviço está temporariamente indisponível. Tentar novamente depois de aguardar o tempo especificado no header "Retry-After".

Setting

Estado da configuração de myscope.

Cache

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

Name Type Description
channel
  • string

Indica o tipo de conta. Os valores permitidos incluem: EA, PAYG, Moderno, Interno, Desconhecido.

id
  • string

ID do recurso usada pelo Resource Manager para identificar exclusivamente o escopo.

name
  • string

Nome de exibição para o escopo.

parent
  • string

ID do recurso do escopo pai. Por exemplo, a ID de recurso da assinatura para um grupo de recursos ou uma ID de recurso de grupo de gerenciamento para uma assinatura.

status
  • string

Indica o status do escopo. O status só se aplica a assinaturas e contas de cobrança.

subchannel
  • string

Indica o tipo de conta moderna. Os valores permitidos incluem: Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Os detalhes do erro.

Name Type Description
code
  • string

Código do erro.

message
  • string

Mensagem de erro indicando por que a operação falhou.

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 é acelerada. Tentar novamente depois de aguardar o tempo especificado no header "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable – o serviço está temporariamente indisponível. Tentar novamente depois de aguardar o tempo especificado no header "Retry-After".

Name Type Description
error

Os detalhes do erro.

Setting

Estado da configuração de myscope.

Name Type Description
id
  • string

ID do recurso.

kind
  • string

Tipo de recurso.

name
  • string

Nome do recurso.

properties.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 Gerenciamento de Custos do Azure na portal do Azure.

properties.startOn enum:
  • LastUsed
  • ScopePicker
  • SpecificScope

Indica a qual escopo o Gerenciamento de Custos no portal do Azure deve ser padrão. Valores permitidos: LastUsed.

type
  • string

Tipo de recurso.