Edita um perímetro da estrutura organizacional.
URL
{RMUrl}/api/Organization/perimeters/<Códigodoperímetro>
MÉTODO DE SOLICITAÇÃO
PUT
PARÂMETRO DA URL
PerimeterCode: esse parâmetro é fornecido na URL e não precisa ser enviado através do PUT.
CONTEÚDO DO FORMULÁRIO
Name (obrigatório): nome do perímetro que será criado. O limite é de 400 caracteres.
Description (opcional): descrição do perímetro que será criado.
AdditionalInformation (opcional): informações adicionais sobre o perímetro que será criado.
Responsible (opcional): pessoa responsável pelo perímetro que será criado.
Latitude (opcional; obrigatório caso o campo "Longitude" esteja preenchido): latitude da localização do perímetro que será criado. 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 perímetro que será criado. 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 perímetro que será criado. O limite é de 1.000 caracteres.
ZoomLevel (opcional): nível de zoom no mapa da localização do perímetro que será criado. Valores válidos: números inteiros entre 0 e 21.
CustomAttributes (opcional): lista de objetos com informações sobre os atributos de perímetros. 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 um perímetro dentro da estrutura organizacional, os campos abaixo podem ser utilizados no formulário.
Path (opcional): caminho na estrutura organizacional para onde o perímetro será movido. O limite é de 400 caracteres para cada perímetro do caminho.
ParentPerimeter (opcional): Id do perímetro pai do perímetro a ser movido.
MappingCriteria
NetbiosName (opcional): utilizado para indicar como deverá ser feito o mapeamento de vulnerabilidades de todos os ativos do perímetro. Nesse caso, por padrão, os nomes NetBIOS identificados por um scanner serão mapeados com ativos através do valor selecionado. Valores válidos: Inherited, Disabled, AssetName, HostAddress ou atributos do tipo Texto criados para ativos tecnológicos.
IPAddress (opcional): utilizado para indicar como deverá ser feito o mapeamento de vulnerabilidades de todos os ativos do perímetro. Nesse caso, por padrão, os endereços IP identificados por um scanner serão mapeados com ativos através do valor selecionado. Valores válidos: Inherited, Disabled, AssetName, HostAddress ou atributos do tipo Texto criados para ativos tecnológicos.
DNSName (opcional): utilizado para indicar como deverá ser feito o mapeamento de vulnerabilidades de todos os ativos do perímetro. Nesse caso, por padrão, os nomes DNS identificados por um scanner serão mapeados com ativos através do valor selecionado. 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.
EXEMPLO DO CONTEÚDO DO FORMULÁRIO
Edição de um perímetro na estrutura organizacional utilizando o campo Path:
{
"Path":"Perímetro 03 > Perímetro 04"
}
Edição de um perímetro na estrutura organizacional utilizando o campo ParentPerimeter:
{
ParentPerimeter:{Id:"dd2fbf95-7bb4-4b3e-9b02-9753909837b6"}
}
Edição dos atributos de um perímetro:
{
"Name":"Perímetro de Marketing",
"Description":"descrição",
"AdditionalInformation":"informação adicional",
"Latitude":-23.761163,
"Longitude":-53.299314,
"GeolocationDescription":"Matriz da empresa",
"ZoomLevel":8,
"Responsible":{"Name":"Alexandre Ferreira"},
"MappingCriteria":
{
"IpAddress": null,
"DnsName": { "Type": "AssetName" },
"NetbiosName": { "Type": "Attribute", "AttributeName": "texto_perimetro" }
},
"CustomAttributes": {
"atributo_datahora":"\/Date(1320335183486)\/",
"atributo_email":"info@exemplo.com.br",
"atributo_link":"http://www.exemplo.com",
"atributo_numero":"999",
"atributo_paragrafo":"Informação importante",
"atributo_texto":"conteudo do atributo",
"atributo_singleselection":"opcaounica",
"atributo_multipleselection":["opcao1","opcao2"],
"atributo_outline":["opcao1","opcao2"],
"atributo_relacionamentomultiplo_grupo":[{"Caption":"Diretoria"},{"Caption":"Informatica"},{"Caption":"Financeiro"},{"Caption":"Recursos Humanos"}]
}
}
RESPOSTA DE SUCESSO
HTTP status code 204: NoContent