ResourcesListOptionalParams interface
Parâmetros opcionais.
- Extends
Propriedades
expand | Lista separada por vírgulas de propriedades adicionais a serem incluídas na resposta. Os valores válidos incluem |
filter | O filtro a ser aplicado na operação. |
top | O número de resultados a serem retornados. Se nulo for passado, retornará todos os recursos. |
Propriedades herdadas
abort |
O sinal que pode ser usado para anular solicitações. |
on |
Uma função a ser chamada sempre que uma resposta é recebida do servidor durante a execução da operação solicitada. Pode ser chamado várias vezes. |
request |
Opções usadas ao criar e enviar solicitações HTTP para essa operação. |
serializer |
Opções para substituir o comportamento de serialização/des serialização. |
tracing |
Opções usadas quando o rastreamento está habilitado. |
Detalhes da propriedade
expand
Lista separada por vírgulas de propriedades adicionais a serem incluídas na resposta. Os valores válidos incluem createdTime
e changedTime
provisioningState
. Por exemplo, $expand=createdTime,changedTime
.
expand?: string
Valor da propriedade
string
filter
O filtro a ser aplicado na operação.
Os operadores de comparação de filtro incluem eq
(iguais) e ne
(não iguais) e podem ser usados com as seguintes propriedades: location
, resourceType
, , name
, resourceGroup
, identity
, identity/principalId
, plan
, plan/publisher
, plan/product
plan/name
, plan/version
e plan/promotionCode
.
Por exemplo, para filtrar por um tipo de recurso, use $filter=resourceType eq 'Microsoft.Network/virtualNetworks'
substringof(value, property)
pode ser usado para filtrar subcadeias de caracteres das seguintes propriedades com suporte no momento: name
e resourceGroup
Por exemplo, para obter todos os recursos com 'demonstração' em qualquer lugar no nome do recurso, use $filter=substringof('demo', name)
Várias operações de subcadeia de caracteres também podem ser combinadas usando and
/or
operadores.
Observe que qualquer número truncado de resultados consultados por meio $top
também pode não ser compatível ao usar um filtro.
Os recursos podem ser filtrados por nomes de marca e valores. Por exemplo, para filtrar um nome de marca e um valor, use $filter=tagName eq 'tag1' and tagValue eq 'Value1'
. Observe que quando os recursos são filtrados pelo nome e pelo valor da marca, as marcas originais de cada recurso não serão retornadas nos resultados. Qualquer lista de propriedades adicionais consultadas por meio $expand
também pode não ser compatível ao filtrar por nomes/valores de marca.
Somente para nomes de marca, os recursos podem ser filtrados por prefixo usando a seguinte sintaxe: $filter=startswith(tagName, 'depart')
. Essa consulta retornará todos os recursos com um nome de marca prefixado pela frase depart
(ou sejadepartment
, departureDate
, departureTime
etc.)
Observe que algumas propriedades podem ser combinadas ao filtrar recursos, que incluem o seguinte: substringof() and/or resourceType
, plan and plan/publisher and plan/name
e identity and identity/principalId
.
filter?: string
Valor da propriedade
string
top
O número de resultados a serem retornados. Se nulo for passado, retornará todos os recursos.
top?: number
Valor da propriedade
number
Detalhes das propriedades herdadas
abortSignal
O sinal que pode ser usado para anular solicitações.
abortSignal?: AbortSignalLike
Valor da propriedade
Herdado de coreClient.OperationOptions.abortSignal
onResponse
Uma função a ser chamada sempre que uma resposta é recebida do servidor durante a execução da operação solicitada. Pode ser chamado várias vezes.
onResponse?: RawResponseCallback
Valor da propriedade
Herdado de coreClient.OperationOptions.onResponse
requestOptions
Opções usadas ao criar e enviar solicitações HTTP para essa operação.
requestOptions?: OperationRequestOptions
Valor da propriedade
Herdado de coreClient.OperationOptions.requestOptions
serializerOptions
Opções para substituir o comportamento de serialização/des serialização.
serializerOptions?: SerializerOptions
Valor da propriedade
Herdado de coreClient.OperationOptions.serializerOptions
tracingOptions
Opções usadas quando o rastreamento está habilitado.
tracingOptions?: OperationTracingOptions
Valor da propriedade
Herdado de coreClient.OperationOptions.tracingOptions