Method: organizations.locations.securityCenterServices.patch

Atualiza um serviço do Security Command Center usando a máscara de atualização especificada.

Solicitação HTTP

PATCH https://securitycentermanagement.googleapis.com/v1/{securityCenterService.name=organizations/*/locations/*/securityCenterServices/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
securityCenterService.name

string

Identificador. O nome do serviço, em um dos seguintes formatos:

  • organizations/{organization}/locations/{location}/securityCenterServices/{service}
  • folders/{folder}/locations/{location}/securityCenterServices/{service}
  • projects/{project}/locations/{location}/securityCenterServices/{service}

Os seguintes valores são válidos para {service}:

  • container-threat-detection
  • event-threat-detection
  • security-health-analytics
  • vm-threat-detection
  • web-security-scanner

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Obrigatório. Os campos a serem atualizados. Aceita os seguintes valores:

  • intendedEnablementState
  • modules

Se omitido, todos os campos qualificados serão atualizados.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
validateOnly

boolean

Opcional. Quando definido como true, a solicitação é validada (incluindo verificações do IAM), mas nenhum serviço é atualizado. Uma resposta OK indica que a solicitação é válida, enquanto uma resposta de erro indica que a solicitação é inválida.

Se a solicitação for válida, uma solicitação subsequente para atualizar o serviço ainda poderá falhar por um dos seguintes motivos:

  • O estado dos seus recursos na nuvem mudou. Por exemplo, você perdeu uma permissão necessária do IAM.
  • Ocorreu um erro durante a atualização do serviço

O valor padrão é false.

Corpo da solicitação

O corpo da solicitação contém uma instância de SecurityCenterService.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de SecurityCenterService.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • securitycentermanagement.securityCenterServices.update

Para mais informações, consulte a documentação do IAM.