REST Resource: projects.locations.consumerEnforcementActions

Risorsa: ConsumerEnforcementAction

Rappresenta un'azione del partner intrapresa per far rispettare il contratto con il fornitore.

Rappresentazione JSON
{
  "name": string,
  "uid": string,
  "etag": string,
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "succeedTime": string,
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "consumerScope": {
    object (ConsumerScope)
  },
  "productScope": {
    object (ProductScope)
  },
  "denyReason": {
    object (DenyReason)
  },

  // Union field action can be only one of the following:
  "projectAccessRestrictionAction": {
    object (ProjectAccessRestrictionConfig)
  }
  // End of list of possible types for union field action.
}
Campi
name

string

Identificatore. Nome della risorsa ConsumerEnforcementAction.

Formato: projects/{project}/locations/{location}/consumerEnforcementActions/{consumerEnforcementAction}

uid

string

Solo output. Identificatore univoco della risorsa.

etag

string

Questo checksum viene calcolato dal server in base al valore di altri campi e può essere inviato nelle richieste di aggiornamento ed eliminazione per garantire che il client disponga di un valore aggiornato prima di procedere.

state

enum (State)

Solo output. Stato attuale del ciclo di vita della risorsa.

createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

succeedTime

string (Timestamp format)

Solo output. Timestamp di esecuzione riuscita dell'azione di applicazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

displayName

string

Facoltativo. Nome visualizzato della risorsa leggibile. La lunghezza massima è di 63 caratteri.

labels

map (key: string, value: string)

Facoltativo. Etichette definite dall'utente per la risorsa.

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

consumerScope

object (ConsumerScope)

Obbligatorio. Immutabile. Ambito del consumatore dell'azione di applicazione.

productScope

object (ProductScope)

Obbligatorio. Immutabile. Ambito del prodotto dell'azione di applicazione.

denyReason

object (DenyReason)

Solo output. Motivo del rifiuto. Presente quando lo stato della risorsa è DENIED.

Campo unione action. Obbligatorio. L'azione di applicazione configurata. action può essere solo uno dei seguenti tipi:
projectAccessRestrictionAction

object (ProjectAccessRestrictionConfig)

Facoltativo. Immutabile. Limita l'accesso al prodotto per i progetti consumer.

ProjectAccessRestrictionConfig

Configurazione di una limitazione dell'accesso che si applica ai progetti consumer.

Mentre una limitazione dell'accesso si applica a un progetto, questo non può essere utilizzato come progetto client nelle richieste di accesso ai servizi forniti dai prodotti pertinenti. La limitazione dell'accesso non è distruttiva e non modifica lo stato di approvvigionamento del consumatore. L'accesso al progetto consumer viene ripristinato automaticamente quando la limitazione viene eliminata o non si applica più a un progetto.

Rappresentazione JSON
{
  "falsePositiveGuardDisabled": boolean
}
Campi
falsePositiveGuardDisabled

boolean

Facoltativo. Controlla se Google protegge dai falsi positivi.

Se abilitata, Google proteggerà da azioni di applicazione disruptive che potrebbero derivare da risultati di falsi positivi di violazione del Contratto con i fornitori o da un'applicazione involontariamente troppo ampia da parte del partner. Google prenderà una decisione in base alle informazioni a sua disposizione in merito all'opportunità di procedere con l'azione di applicazione e, a sua discrezione, potrà negare l'azione di applicazione. A sua discrezione, Google può fornire dettagli sui motivi della sua decisione quando un'azione di applicazione richiesta viene negata, ma non è obbligata a farlo e può prendere decisioni basate su informazioni che non possono essere condivise con il partner. Se il partner non è d'accordo con la decisione, può applicare un nuovo provvedimento senza la protezione.

Stato

Rappresenta lo stato del ciclo di vita dell'azione di applicazione.

In futuro potrebbero essere aggiunti nuovi valori a questa enumerazione.

Enum
STATE_UNSPECIFIED Stato non specificato. Non utilizzata.
RUNNING

Il provvedimento è in corso. Questo è lo stato iniziale della risorsa e persiste durante l'esecuzione dell'operazione a lunga esecuzione consumerEnforcementActions.create.

Se l'operazione viene annullata o termina prima che si verifichino effetti di applicazione, la risorsa verrà rimossa. In caso contrario, al termine dell'operazione lo stato della risorsa verrà risolto in uno dei seguenti stati.

  • Se l'azione di applicazione viene accettata e applicata correttamente, al termine lo stato passerà a SUCCEEDED.
  • Se l'azione di applicazione viene negata, al termine lo stato passerà a DENIED.
  • Se l'azione di applicazione non va a buon fine dopo l'applicazione parziale degli effetti di applicazione, lo stato passerà a FAILED per riflettere lo stato di applicazione parziale incoerente.
SUCCEEDED L'azione di applicazione è stata accettata e applicata correttamente. Qualsiasi effetto in corso dell'azione di applicazione è attivo.
DENIED Il provvedimento non è stato accettato e non è entrato in vigore per il motivo descritto in denyReason.
FAILED Una transizione di stato non è riuscita a causa di un errore di sistema temporaneo o interno. Il comportamento di applicazione potrebbe essere incoerente. L'eliminazione di una risorsa in questo stato rimuoverà tutti gli effetti in corso.

ConsumerScope

Specifica l'entità risorsa consumer di destinazione per l'azione di applicazione.

Rappresentazione JSON
{

  // Union field target_consumer_entity can be only one of the following:
  "project": string,
  "billingAccount": string,
  "organization": string
  // End of list of possible types for union field target_consumer_entity.
}
Campi
Campo unione target_consumer_entity. Obbligatorio. Deve essere impostato esattamente un identificatore di risorsa di destinazione. target_consumer_entity può essere solo uno dei seguenti tipi:
project

string

Ha come target una singola risorsa del progetto. L'ambito dell'azione di applicazione è limitato al progetto specificato.

Deve esistere al momento della creazione dell'azione di applicazione. Deve essere specificato utilizzando il formato project_number.

Formato: projects/{project_number}

billingAccount

string

Ha come target una risorsa dell'account di fatturazione. L'ambito dell'azione di applicazione riguarda l'account di fatturazione e tutti i progetti collegati.

Questo ambito è dinamico. Gli effetti applicati al momento della creazione dell'azione di applicazione vengono applicati alle entità nell'ambito in quel momento. Gli effetti in corso dell'azione di applicazione vengono applicati alle entità nell'ambito al momento pertinente.

Deve esistere al momento della creazione dell'azione di applicazione. Questo campo non può essere utilizzato per scegliere come target un account di fatturazione del rivenditore padre.

Formato: billingAccounts/{billingAccount}

organization

string

Ha come target una risorsa dell'organizzazione. L'ambito dell'azione di applicazione copre tutti i progetti all'interno dell'organizzazione, nonché tutti gli account di fatturazione all'interno dell'organizzazione e tutti i progetti collegati a questi account di fatturazione.

Questo ambito è dinamico. Gli effetti applicati al momento della creazione dell'azione di applicazione vengono applicati alle entità nell'ambito in quel momento. Gli effetti in corso dell'azione di applicazione vengono applicati alle entità nell'ambito al momento pertinente.

Deve esistere al momento della creazione dell'azione di applicazione.

Formato: organizations/{organization}

ProductScope

Definisce l'ambito del prodotto dell'azione di applicazione.

Rappresentazione JSON
{
  "aiplatformPublisherId": string
}
Campi
aiplatformPublisherId

string

Facoltativo. Ha come target tutti i prodotti modello gestiti in AI Platform Model Garden di cui è genitore l'ID publisher specificato.

In AI Platform Model Garden, un publisher_id identifica il publisher del modello. Ai partner con prodotti disponibili in Model Garden viene assegnato un ID publisher univoco al momento del primo onboarding. È possibile specificare solo l'ID publisher di un partner. Se non conosci il tuo ID publisher, contatta l'assistenza per i partner per ricevere assistenza.

Formato: {publisher_id} (ad es. google).

DenyReason

Spiegazione del motivo per cui non è stata applicata un'azione di applicazione.

Rappresentazione JSON
{
  "reasonCode": enum (ReasonCode),
  "detailMessage": string
}
Campi
reasonCode

enum (ReasonCode)

Solo output. Il codice motivo. Sempre presente quando l'applicazione non viene concessa.

detailMessage

string

Solo output. Messaggio aggiuntivo facoltativo leggibile che spiega perché l'azione di applicazione è stata negata.

ReasonCode

Codice che indica il motivo per cui l'azione di applicazione è stata rifiutata da Google.

Enum
REASON_CODE_UNSPECIFIED Motivo non specificato. Non utilizzata.
EXEMPT L'entità consumer di destinazione (o una sottoentità di livello inferiore nella gerarchia delle entità) è esente dall'applicazione avviata dall'API dell'azione di applicazione richiesta. Per procedere con l'applicazione nei confronti del consumatore, contatta Google.
FALSE_POSITIVE_GUARD L'azione di applicazione è stata negata perché è stata richiesta la modalità di protezione dai falsi positivi e la protezione dai falsi positivi è stata attivata.

Metodi

create

Crea una risorsa ConsumerEnforcementAction.

delete

Elimina una risorsa ConsumerEnforcementAction.

get

Recupera una risorsa ConsumerEnforcementAction per nome.

list

Elenca ConsumerEnforcementActions in una località principale.

patch

Aggiorna una risorsa ConsumerEnforcementAction esistente.