REST Resource: customers.policySchemas

{
  "name": string,
  "policyDescription": string,
  "additionalTargetKeyNames": [
    {
      object (AdditionalTargetKeyName)
    }
  ],
  "definition": {
    object (FileDescriptorProto)
  },
  "fieldDescriptions": [
    {
      object (PolicySchemaFieldDescription)
    }
  ],
  "accessRestrictions": [
    string
  ],
  "notices": [
    {
      object (PolicySchemaNoticeDescription)
    }
  ],
  "supportUri": string,
  "schemaName": string,
  "validTargetResources": [
    enum (TargetResource)
  ],
  "policyApiLifecycle": {
    object (PolicyApiLifecycle)
  },
  "categoryTitle": string,
  "supportedPlatforms": [
    enum (Platform)
  ]
}

string

Formato: name=customers/{customer}/policySchemas/{schema_namespace}

string

Solo output. Descrizione dello schema dei criteri per il consumo da parte degli utenti.

object (AdditionalTargetKeyName)

Solo output. Nomi di chiavi aggiuntivi che verranno utilizzati per identificare la destinazione del valore del criterio. Quando specifichi un valore policyTargetKey, ogni chiave aggiuntiva specificata qui dovrà essere inclusa nella mappa additionalTargetKeys.

object (FileDescriptorProto)

Definizione dello schema mediante descrittore di protocollo.

object (PolicySchemaFieldDescription)

Solo output. Descrizione dettagliata di ciascun campo che fa parte dello schema. È consigliabile che i campi vengano visualizzati in base all'ordine all'interno dell'elenco, non in base al numero.

string

Solo output. Limitazioni di accesso specifiche relative a questo criterio.

object (PolicySchemaNoticeDescription)

Solo output. Messaggi di avviso speciale relativi all'impostazione di determinati valori in determinati campi dello schema.

string

Solo output. URI dell'articolo di assistenza correlato per questo schema.

string

Solo output. Il nome completo dello schema dei criteri. Questo valore viene utilizzato per compilare il campo policySchema in PolicyValue durante la chiamata a BatchInheritOrgUnitPolicies BatchModifyOrgUnitPolicies BatchModifyGroupPolicies o BatchDeleteGroupPolicies.

enum (TargetResource)

Solo output. Informazioni sulle risorse di destinazione applicabili per il criterio.

object (PolicyApiLifecycle)

Solo output. Informazioni attuali sul ciclo di vita.

string

Titolo della categoria a cui appartiene un'impostazione.

enum (Platform)

Solo output. L'elenco indica che il criterio verrà applicato solo ai dispositivi/utenti su queste piattaforme.

{
  "key": string,
  "keyDescription": string
}

string

Nome chiave.

string

Descrizione della chiave.

{
  "name": string,
  "package": string,
  "messageType": [
    {
      object (DescriptorProto)
    }
  ],
  "enumType": [
    {
      object (EnumDescriptorProto)
    }
  ],
  "syntax": string,
}

string

nome del file, rispetto alla radice dell'albero di origine

string

ad es. "foo", "foo.bar" e così via.

object (DescriptorProto)

Tutte le definizioni di primo livello in questo file.

object (EnumDescriptorProto)

string

La sintassi del file proto. I valori supportati sono "proto2", "proto3" ed "editions".

Se è presente edition, questo valore deve essere "versioni".

{
  "name": string,
  "field": [
    {
      object (FieldDescriptorProto)
    }
  ],
  "nestedType": [
    {
      object (DescriptorProto)
    }
  ],
  "enumType": [
    {
      object (EnumDescriptorProto)
    }
  ],
  "oneofDecl": [
    {
      object (OneofDescriptorProto)
    }
  ]
}

string

object (FieldDescriptorProto)

object (DescriptorProto)

object (EnumDescriptorProto)

object (OneofDescriptorProto)

{
  "name": string,
  "number": integer,
  "label": enum (Label),
  "type": enum (Type),
  "typeName": string,
  "defaultValue": string,
  "oneofIndex": integer,
  "jsonName": string,
  "proto3Optional": boolean
}

string

integer

enum (Label)

enum (Type)

Se typeName è impostato, non è necessario impostarlo. Se è impostato sia questo valore che typeName, il valore deve essere TYPE_ENUM, TYPE_MESSAGE o TYPE_GROUP.

string

Per i tipi di messaggio ed enum, questo è il nome del tipo. Se il nome inizia con un punto ".", è valido. In caso contrario, per trovare il tipo vengono utilizzate regole di ambito di tipo C++ (la ricerca viene eseguita prima nei tipi nidificati all'interno di questo messaggio, poi nell'elemento padre, fino allo spazio dei nomi principale).

string

Per i tipi numerici, contiene la rappresentazione testuale originale del valore. Per i valori booleani, "true" o "false". Per le stringhe, contiene i contenuti di testo predefiniti (senza caratteri di escape). Per i byte, contiene il valore con escape C. Tutti i byte >= 128 sono sottoposti a escape.

integer

Se impostato, restituisce l'indice di un oneof nell'elenco oneofDecl del tipo contenitore. Questo campo fa parte di questo campo.

string

Nome JSON di questo campo. Il valore è impostato dal compilatore di protocollo. Se l'utente ha impostato un valore "jsonName" in questo campo, verrà utilizzato il valore di tale opzione. In caso contrario, viene dedotto dal nome del campo convertendolo in camelCase.

boolean

Se true, si tratta di un proto3 "facoltativo". Quando un campo proto3 è facoltativo, monitora la presenza indipendentemente dal tipo di campo.

Se proto3Optional è true, questo campo deve appartenere a un altro per segnalare ai vecchi client proto3 che la presenza viene monitorata per questo campo. Questa sintetica è nota come "sintetico" unodi e questo campo deve essere il suo unico membro (ogni campo facoltativo proto3 riceve il proprio uno di sintetico). Gli elementi sintetici esistono solo nel descrittore e non generano API. Gli elementi sintetici devono essere ordinati dopo che tutto è "reale" oneofs.

Per i campi del messaggio, proto3Optional non crea alcuna modifica semantica, poiché i campi del messaggio non ripetuti tengono sempre traccia della presenza. Tuttavia, indica ancora i dettagli semantici che indicano se l'utente ha scritto "facoltativo" o meno. Questo può essere utile per fare il round trip del file .proto. Per coerenza, forniamo anche ai campi dei messaggi uno sintetico, anche se non è obbligatorio monitorare la presenza. Questo è particolarmente importante perché il parser non è in grado di capire se un campo è un messaggio o un'enumerazione, quindi deve sempre crearne uno sintetico.

I campi facoltativi Proto2 non impostano questo flag perché sono già facoltativi con LABEL_OPTIONAL.

{
  "name": string,
  "value": [
    {
      object (EnumValueDescriptorProto)
    }
  ]
}

string

object (EnumValueDescriptorProto)

{
  "name": string,
  "number": integer
}

string

integer

{
  "name": string
}

string

{
  "field": string,
  "description": string,
  "inputConstraint": string,
  "knownValueDescriptions": [
    {
      object (PolicySchemaFieldKnownValueDescription)
    }
  ],
  "nestedFieldDescriptions": [
    {
      object (PolicySchemaFieldDescription)
    }
  ],
  "fieldDependencies": [
    {
      object (PolicySchemaFieldDependencies)
    }
  ],
  "requiredItems": [
    {
      object (PolicySchemaRequiredItems)
    }
  ],
  "defaultValue": value,
  "name": string,
  "fieldDescription": string,
  "fieldConstraints": {
    object (FieldConstraints)
  }
}

string

Solo output. Il nome del campo per associato a questa descrizione.

string

Deprecato. Utilizza invece name e fieldDescription. La descrizione del campo.

string

Solo output. Eventuali vincoli di input associati ai valori per il campo.

object (PolicySchemaFieldKnownValueDescription)

Solo output. Se il campo ha un insieme di valori noti, questo campo fornisce una descrizione per questi valori.

object (PolicySchemaFieldDescription)

Solo output. Fornisce la descrizione dei campi nidificati in questo campo, se il campo è un tipo di messaggio che definisce più campi. È consigliabile che i campi vengano visualizzati in base all'ordine all'interno dell'elenco, non in base al numero.

object (PolicySchemaFieldDependencies)

Solo output. Fornisce un elenco di campi e valori. Almeno uno dei campi deve contenere il valore corrispondente per poter essere impostato.

object (PolicySchemaRequiredItems)

Solo output. Fornisce un elenco di campi che è obbligatorio impostare se questo campo ha un determinato valore.

value (Value format)

Solo output. Se il criterio non viene configurato, è il valore predefinito del client.

string

Solo output. Il nome del campo.

string

Solo output. La descrizione del campo.

object (FieldConstraints)

Solo output. Informazioni su eventuali vincoli di input associati ai valori per il campo.

{
  "value": string,
  "description": string,
  "fieldDependencies": [
    {
      object (PolicySchemaFieldDependencies)
    }
  ]
}

string

Solo output. La rappresentazione stringa del valore che è possibile impostare per il campo.

string

Solo output. Descrizione aggiuntiva per questo valore.

object (PolicySchemaFieldDependencies)

Solo output. Condizioni dei campi obbligatorie per la validità di questo valore.

{
  "sourceField": string,
  "sourceFieldValue": string
}

string

Il campo di origine da cui dipende questo campo.

string

Il valore che deve contenere il campo di origine per consentire l'impostazione di questo campo.

{
  "fieldConditions": [
    string
  ],
  "requiredFields": [
    string
  ]
}

string

I valori del campo che causano l'applicazione forzata dei campi obbligatori. Un campo Conditions vuoto implica che qualsiasi valore assegnato a questo campo provocherà l'applicazione forzata dei campi obbligatori.

string

Campi obbligatori per effetto delle condizioni dei campi.

{
  "numericRangeConstraint": {
    object (NumericRangeConstraint)
  },
  "uploadedFileConstraints": {
    object (UploadedFileConstraints)
  }
}

object (NumericRangeConstraint)

L'intervallo consentito per i campi numerici.

object (UploadedFileConstraints)

Vincoli sul file caricato di un criterio del file. Se presente, questo criterio richiede un URL che possa essere recuperato caricando un file con i vincoli specificati in questo protocollo.

{
  "minimum": string,
  "maximum": string
}

string (int64 format)

Valore minimo.

string (int64 format)

Valore massimo.

{
  "supportedContentTypes": [
    enum (ContentType)
  ],
  "sizeLimitBytes": string
}

enum (ContentType)

Tipi di file che possono essere caricati per un'impostazione.

string (int64 format)

Il limite per le dimensioni dei file caricati per un'impostazione, in byte.

{
  "field": string,
  "noticeValue": string,
  "noticeMessage": string,
  "acknowledgementRequired": boolean
}

string

Solo output. Il nome del campo associato alla notifica.

string

Solo output. Il valore del campo che contiene una notifica. Quando il campo viene impostato su questo valore, all'utente potrebbe essere richiesto di confermare il messaggio di avviso affinché il valore venga impostato.

string

Solo output. Il messaggio di avviso associato al valore del campo.

boolean

Solo output. Indica se l'utente deve confermare il messaggio di avviso prima di poter impostare il valore.

{
  "deprecatedInFavorOf": [
    string
  ],
  "scheduledToDeprecatePolicies": [
    string
  ],
  "policyApiLifecycleStage": enum (PolicyApiLifecycleEnum),
  "description": string,
  "endSupport": {
    object (Date)
  }
}

string

Nel caso in cui questo criterio venga ritirato a favore di un altro criterio, lo spazio dei nomi completo o gli spazi dei nomi completi dei nuovi criteri verranno visualizzati in PolicyAPI. Può essere impostato solo se policyApiLifecycleStage è API_DEPRECATED.

string

Corrispondenti all'InFavorOf deprecato, uno o più spazi dei nomi completi dei criteri precedenti che verranno ritirati a causa dell'introduzione di questo criterio.

enum (PolicyApiLifecycleEnum)

Indica la fase attuale del ciclo di vita dell'API dei criteri.

string

Descrizione del ciclo di vita attuale.

object (Date)

Data di fine del supporto per le norme attuali. Il tentativo di modificare un criterio dopo la data di fine del supporto comporterà una richiesta errata (errore 400). Può essere impostato solo se policyApiLifecycleStage è API_DEPRECATED.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

integer

Mese dell'anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo.