REST Resource: organizations.locations.postureDeployments

Risorsa: PostureDeployment

Dettagli di un deployment Posture in un'organizzazione, una cartella o un progetto.

Puoi implementare al massimo una postura per ogni organizzazione, cartella o progetto. La risorsa principale per il deployment di una configurazione di sicurezza è sempre l'organizzazione, anche se il deployment si applica a una cartella o a un progetto.

Rappresentazione JSON 
{
  "name": string,
  "targetResource": string,
  "state": enum (State),
  "postureId": string,
  "postureRevisionId": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "reconciling": boolean,
  "desiredPostureId": string,
  "desiredPostureRevisionId": string,
  "failureMessage": string,
  "categories": [
    enum (Category)
  ]
}
Campi
name

string

Obbligatorio. Identificatore. Il nome del deployment della configurazione di sicurezza, nel formato organizations/{organization}/locations/global/postureDeployments/{deployment_id}.
targetResource

string

Obbligatorio. L'organizzazione, la cartella o il progetto in cui è implementata la postura. Utilizza uno dei seguenti formati:

  • organizations/{organization_number}
  • folders/{folder_number}
  • projects/{project_number}
state

enum (State)

Solo output. Lo stato del deployment della postura.
postureId

string

Obbligatorio. La postura utilizzata nel deployment, nel formato organizations/{organization}/locations/global/postures/{postureId}.
postureRevisionId

string

Obbligatorio. L'ID revisione della postura utilizzata nel deployment.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato il deployment della 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 del deployment della 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".
description

string

Facoltativo. Una descrizione del deployment della postura.
etag

string

Facoltativo. Un identificatore opaco per la versione corrente del deployment della posizione.

Per evitare che gli aggiornamenti simultanei si sovrascrivano a vicenda, specifica sempre etag quando aggiorni un deployment di posture. Puoi anche fornire il valore etag quando elimini un deployment di posture per assicurarti di eliminare quello previsto.
annotations

map (key: string, value: string)

Facoltativo. Le annotazioni specificate dall'utente per il deployment della 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 il deployment della postura è in fase di aggiornamento.
desiredPostureId

string

Solo output. L'ID della postura specificato per il deployment. Presente solo se il deployment della postura è in uno stato di errore.
desiredPostureRevisionId

string

Solo output. L'ID revisione della postura specificata per il deployment. Presente solo se il deployment è in uno stato di errore.
failureMessage

string

Solo output. Una descrizione del motivo per cui il deployment della postura non è riuscito. Presente solo se il deployment è in uno stato di errore.
categories[]

enum (Category)

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

Stato

Lo stato di un PostureDeployment.

Enum
STATE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
CREATING Il deployment della postura è in fase di creazione.
DELETING Il deployment della configurazione di sicurezza è in fase di eliminazione.
UPDATING Il deployment della configurazione di sicurezza è in fase di aggiornamento.
ACTIVE Il deployment della postura è attivo e in uso.
CREATE_FAILED Impossibile creare il deployment della postura.
UPDATE_FAILED Impossibile aggiornare il deployment della postura.
DELETE_FAILED Impossibile eliminare il deployment della postura.

Metodi

create

 Crea un nuovo PostureDeployment in un determinato progetto e posizione.

delete

 Consente di eliminare un PostureDeployment.

get

 Recupera i dettagli di un PostureDeployment.

list

 Elenca tutti i PostureDeployment in un progetto e in una località.

patch

 Aggiorna un PostureDeployment esistente.