Edita um ativo na estrutura organizacional.
URL
{RMUrl}/api/organization/assets/<Códigodoativo>
MÉTODO DE SOLICITAÇÃO
PUT
PARÂMETRO DA URL
AssetCode: esse parâmetro é fornecido na URL e não precisa ser enviado através do PUT.
CONTEÚDO DO FORMULÁRIO
Name (opcional): nome do ativo. O limite é de 400 caracteres.
Responsible (opcional): pessoa responsável pelo ativo.
Relevance (opcional): relevância do ativo. Valores válidos: números inteiros entre 1 e 5, com 1 (Muito Baixa), 2 (Baixa), 3 (Média), 4 (Alta) e 5 (Muito Alta).
Criticality (opcional): criticidade do ativo. Valores válidos: números reais positivos de 1 a 100.
AnalysisFrequency (opcional): periodicidade da análise, em dias. Valores válidos: números inteiros positivos. O máximo é de 1.000 dias.
Description (opcional): descrição do ativo.
Latitude (opcional; obrigatório caso o campo "Longitude" esteja preenchido): latitude da localização do ativo. Valores válidos: de -90.0 a +90.0. A marcação decimal deve ser representada por um ponto e não por uma vírgula.
Longitude (opcional; obrigatório caso o campo "Latitude" esteja preenchido): longitude da localização do ativo. Valores válidos: de -180.0 a +180.0. A marcação decimal deve ser representada por um ponto e não por uma vírgula.
GeolocationDescription (opcional): descrição da localização geográfica do ativo. O limite é de 1.000 caracteres.
ZoomLevel (opcional): nível de zoom no mapa da localização do ativo. Valores válidos: números inteiros entre 0 e 21.
CustomAttributes (opcional): lista de objetos com informações sobre os atributos de ativos. Cada atributo é referenciado através do nome da variável. Os atributos do tipo Relacionamento podem ser referenciados pelo campo Id, pelo campo Caption (nome que identifica o objeto) ou pelos dois campos. Caso os dois campos sejam fornecidos, eles devem referenciar o mesmo objeto. É recomendado que, sempre que possível, seja dada preferência ao campo Id. Para obter a lista de formatos dos campos Id e Caption, veja o tópico Apêndice 2: Formato de preenchimento dos atributos.
Para mover o ativo dentro da estrutura organizacional, os campos abaixo podem ser utilizados no formulário.
Path (opcional): caminho na estrutura organizacional para onde o ativo será movido. O limite é de 400 caracteres para cada perímetro do caminho.
ParentPerimeter (opcional): ID do novo perímetro do ativo.
Se o ativo for do tipo Tecnologia, os campos abaixo também podem ser enviados no formulário:
CollectionParameters
HostAddress (opcional): endereço do ativo que será coletado.
Credentials (opcional): credenciais utilizadas para acessar a máquina alvo.
CollectorServer (opcional): servidor de coleta utilizado para gerenciar a coleta.
MappingCriteria
NetbiosName (opcional): nome que será mapeado com o nome NetBIOS identificado por um scanner de vulnerabilidades. Valores válidos: Inherited, Disabled, AssetName, HostAddress ou atributos do tipo Texto criados para ativos tecnológicos.
IPAddress (opcional): endereço IP que será mapeado com o endereço IP identificado por um scanner de vulnerabilidades. Valores válidos: Inherited, Disabled, AssetName, HostAddress ou atributos do tipo Texto criados para ativos tecnológicos.
DNSName (opcional): nome DNS que será mapeado com o nome DNS identificado por um scanner de vulnerabilidades. Valores válidos: Inherited, Disabled, AssetName, HostAddress ou atributos do tipo Texto criados para ativos tecnológicos.
Nota: o envio do valor "null" nos campos dos CustomAttributes significa que os valores inseridos serão apagados. Já nos outros campos, o envio do valor "null" significa que serão ignorados.
EXEMPLOS DO CONTEÚDO DO FORMULÁRIO
Edição de um ativo tecnológico:
{
"Name":"Tablet do Diretor",
"Relevance":3,
"Criticality":4,
"AnalysisFrequency":100,
"Description":"1111",
"Latitude":-23.761163,
"Longitude":-53.299314,
"GeolocationDescription":"Matriz da empresa",
"ZoomLevel":8,
"Responsible":{"Name":"Alexandre Ferreira"},
"CollectionParameters":
{
"CollectorServer": "Servidor de Coleta",
"Credentials": "senhas de acesso",
"HostAddress": "10.1.1.2"
},
"MappingCriteria":
{
"IpAddress": null,
"DnsName": { "Type": "AssetName" },
"NetbiosName": { "Type": "Attribute", "AttributeName": "texto_ativo" }
}
"CustomAttributes": {
"atributo_relacionamentosimples_ativo":{
"Caption":"Diretoria > Fulano"},
"atributo_relacionamentomultiplo_grupo":[{"Caption":"Diretoria"},{"Caption":"Informatica"},{"Caption":"Financeiro"},{"Caption":"Recursos Humanos"}]
}
}
Relocação de um ativo na estrutura organizacional utilizando o campo Path:
{
"Path":"Perímetro 03 > Perímetro 04"
}
Relocação de um ativo na estrutura organizacional utilizando o campo ParentPerimeter:
{
ParentPerimeter:{Id:"dd2fbf95-7bb4-4b3e-9b02-9753909837b6"}
}
RESPOSTA DE SUCESSO
HTTP status code 204: NoContent