Lista - API de Enriquecimento de Dados
Aplica-se a: Microsoft Cloud App Security
Importante
Os nomes dos produtos de proteção contra ameaças da Microsoft estão a mudar. Leia mais sobre esta e outras atualizações aqui. Vamos atualizar nomes em produtos e nos documentos num futuro próximo.
Executar o pedido GET ou POST para obter uma lista de intervalos IP correspondentes aos filtros especificados.
Pedido HTTP
GET /api/v1/subnet/
POST /api/v1/subnet/
Solicitar parâmetros BODY
| Parâmetro | Descrição |
|---|---|
| filtros | Filtrar objetos com todos os filtros de pesquisa para o pedido, consulte filtros de gama IP para mais detalhes |
| classificaçãoDirect | A direção de triagem. Os valores possíveis são: asc e desc |
| classificarfield | Os campos costumavam classificar os intervalos de IP. Os valores possíveis são: - categoria: A categoria da gama IP - tags: As etiquetas da gama IP - nome: O nome da gama IP |
| saltar | Ignora o número especificado de registos |
| limit | Número máximo de registos devolvidos pelo pedido |
Exemplo
Pedir
Aqui está um exemplo do pedido.
curl -XPOST -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.contoso.com/api/v1/subnet/" -d '{
"filters": {
// some filters
},
"skip": 5,
"limit": 10
...
}'
Resposta
Devolve uma lista de gamas IP no formato JSON. Para obter informações sobre os campos de resposta, consulte Propriedades.
{
"total": 1 // total number of records
"hasNext": false // whether there is more data to show or not.
"data": [
{
// returned records
"_id": "5fd767259cd24bb563567d7c",
"name": "range name",
"subnets": [
{
"mask": 112,
"address": "0000:0000:0000:0000:0000:ffff:c5c6:0000",
"originalString": "197.198.192.20/16"
}
],
"location": {
"name": "United States",
"latitude": 39.5035514831543,
"longitude": -99.01830291748047,
"countryCode": "US",
"countryName": "United States"
},
"organization": "isp name",
"tags": [
{
"_id": "5ce2aaf42207ad108c76fa3a",
"id": "000000290000000000000000",
"target": 1,
"type": 2,
"name": "Contoso",
"nameTemplate": {
"template": "SAGE_BUILTIN_TAG_CONTOSO_NAME"
},
"description": "IP addresses used by Contoso",
"descriptionTemplate": {
"template": "SAGE_BUILTIN_TAG_CONTOSO_DESCRIPTION"
},
"visibility": 0,
"status": 0,
"_tid": 113348336
}
],
"category": 5,
"lastModified": 1607952165309.8032,
"_tid": 113348336
}
]
}
Se tiver algum problema, estamos aqui para ajudar. Para obter assistência ou suporte para o seu problema de produto, abra um bilhete de apoio.