REST Resource: organizations.locations.postures

Risorsa: Posture

I dettagli di una postura.

Rappresentazione JSON
{
  "name": string,
  "state": enum (State),
  "revisionId": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "policySets": [
    {
      object (PolicySet)
    }
  ],
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "reconciling": boolean,
  "categories": [
    enum (Category)
  ]
}
Campi
name

string

Obbligatorio. Identificatore. Il nome della postura, nel formato organizations/{organization}/locations/global/postures/{postureId}.

state

enum (State)

Obbligatorio. Lo stato della postura al revisionId specificato.

revisionId

string

Solo output. Immutabile. Una stringa opaca di otto caratteri che identifica la revisione della postura. Una configurazione di sicurezza può avere più revisioni. Quando esegui il deployment di una configurazione di sicurezza, ne esegui il deployment di una revisione specifica.

createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata la postura.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento della configurazione di sicurezza.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

description

string

Facoltativo. Una descrizione della postura.

policySets[]

object (PolicySet)

Obbligatorio. Le risorse PolicySet incluse nella postura.

etag

string

Facoltativo. Un identificatore opaco per la versione corrente della posizione al revisionId specificato.

Per evitare che gli aggiornamenti simultanei si sovrascrivano a vicenda, fornisci sempre il valore etag quando aggiorni una postura. Puoi anche fornire il etag quando elimini una posa per assicurarti di eliminare la versione prevista della posa.

annotations

map (key: string, value: string)

Facoltativo. Le annotazioni specificate dall'utente per la postura.

Per informazioni dettagliate sui valori che puoi utilizzare in un'annotazione, vedi AIP-148: campi standard.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

reconciling

boolean

Solo output. Indica se la configurazione di sicurezza è in fase di aggiornamento.

categories[]

enum (Category)

Solo output. Le categorie a cui appartiene la postura, come stabilito dall'API Security Posture.

Stato

Lo stato di un Posture.

Enum
STATE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
DEPRECATED La configurazione di sicurezza è stata ritirata e non è più possibile eseguirne il deployment.
DRAFT La configurazione di sicurezza è una bozza e non è pronta per il deployment.
ACTIVE La configurazione di sicurezza è completata ed è pronta per il deployment.

Metodi

create

Crea un nuovo Posture.

delete

Consente di eliminare tutte le revisioni di un Posture.

extract

Estrae i criteri esistenti da un'organizzazione, una cartella o un progetto e li applica a un'altra organizzazione, cartella o progetto come Posture.

get

Recupera una singola revisione di un Posture.

list

Elenca le revisioni più recenti di tutte le risorse Posture in un'organizzazione e una località specificate.

listRevisions

Elenca tutte le revisioni di un singolo Posture.

patch

Aggiorna una revisione di un Posture esistente.