Get the Site Management Settings
/sites/management/api/v1/settings
Provides service wide sites managements related settings, such as controlling who can create sites, templates, themes and components, enabling site governance and whether the site prerender service is enabled.
Introduced in release 20.1.2.
Successful Response Examples
This operation responds with the following success (2xx) responses. For a full list of response HTTP status codes and example bodies, consult the Response section of this operation.
200OK
Request
GET https://api.example.com/sites/management/api/v1/settings
Response Body
{ "allowSiteCreation": false, "governanceEnabled": false, "siteSecurityPolicy": { "level": "service", "appliesTo": "named" }, "siteAdminOnlyOperations": { "siteCreation": false, "templateCreation": false, "themeCreation": false, "componentCreation": false }, "prerender": { "enabled": false, "userAgents": "AdsBot-Google,AdsBot-Google-Mobile-Apps,AppEngine-Google" }, "expiration": { "action": "nothing", "deleteAfter": 30 } }
Request
-
excludeFields(optional): string
Comma-delimited string of field names that should not be included in the response.
-
excludeLinks(optional): string
Comma-separated list of link relation names to exclude from the response.
-
fields(optional): string
Comma-delimited string of field names to include in the response. Nested fields can be identified using a dot to separate the field names. Field names are case-sensitive. Field names are ignored if the field does not exist.
-
links(optional): string
Comma-separated list of link relation names to include in the response. By default, all links are returned.
The following links are provided by this resource:
Link Relationship Description parentDescribes where the parent resource can be read. Equivalent to an uplink, this link provides the link to the parent resource, such as the collection resource that contains a singular resource.selfDescribes the current returned representation of the resource. Used for links that represent the resource itself. For example, if a resource is returned as part of a collection, the self link will provide the URL path for the individual resource. canonicalDescribes the preferred representation of the requested resource. Used for links that represent the canonical form of the resource. For example, if a resource is returned as part of a collection, the canonical link will provide the URL path for the canonical form of the individual resource. editDescribes where the resource can be edited. Used on singular resources to indicate where a patch can be performed to edit an existing resource. edit-formDescribes where a template request body for editing a resource can be read. The edit form provides details of what properties can be used to edit a resource. describedByDescribes the schema resource providing metadata information about the resource. Used on collection, singular and relation resources to indicate where the schema resource is that describes the resource. -
return(optional): string
Specify the resource representation that should be used to control the response fields and links. If no representation is specified, the client-defined representation is returned, based on the values of the
fields,excludeFields,links,excludeLinksandexpandquery parameters.The following representations are supported with the
returnquery parameter:Representation Description representationFull resource representation includes all properties and links and expands most relationships. defaultDefault resource representation includes most properties and links. basicBasic resource representation includes some properties and some links. minimalMinimal resource representation, includes essential properties and no links.
Response
- application/json
- application/vnd.oracle.resource+json;type=singular
200 Response
-
Cache-Control: string
Directives for caching mechanisms.
-
Content-Length: string
Size of the response body.
-
Content-Type: string
Content type of the response.
-
allOf
SitesManagementSettings
Sites Management settings.
Introduced in release 20.1.2.
Sites Management settings.
Introduced in release 20.1.2.-
object
SingularResource
All singular resources include the properties of the singular resource definition. A singular resource includes a list of links that provide relationships to other resources, or in the case of the self link the resource itself.
-
object
SitesManagementSettings-allOf[1]
objectAll singular resources include the properties of the singular resource definition. A singular resource includes a list of links that provide relationships to other resources, or in the case of the self link the resource itself.
-
links(optional):
array links
HATEOS link to related resources and actions or actions on this resource. Must include at least a 'self' link that contains a link to the canonical representation of the resource.
object-
allowSiteCreation(optional):
boolean
Allow your service users to create sites. When you enable the ability to create sites, you allow all users to create templates and sites. If you disable site creation, users can still see and work with templates and other folders in the hierarchy. Users can also still work with an existing site if the site is shared with them. They can view, edit, and manage the site, depending on their role. When you enable sites functionality, users have the ability to publish any content they have access to, including confidential information. You might want to limit your users to creating only secured sites, so that users have to sign in before they can see the site content. For even more security, you can limit site creation to administrators.
Introduced in release 20.1.2. -
expiration(optional):
expiration
Site expiration settings such as whether sites are automatically taken offline and deleted when the site expires.
Introduced in release 20.3.1. -
governanceEnabled(optional):
boolean
Enable governance for sites to simplify and accelerate site delivery for business users, who are not site administrators, while giving site administrators an easy way to control and track sites from a centralized location.
Introduced in release 20.1.2. -
prerender(optional):
prerender
Prerender service settings such as whether the prerender service is enabled.
Introduced in release 20.1.2. -
siteAdminOnlyOperations(optional):
siteAdminOnlyOperations
Restrict site, template, theme and component creation to site administrators.
Introduced in release 20.1.2. -
siteSecurityPolicy(optional):
siteSecurityPolicy
Specify the minimum security allowed for online sites.
Introduced in release 20.1.2.
arrayHATEOS link to related resources and actions or actions on this resource. Must include at least a 'self' link that contains a link to the canonical representation of the resource.
objectREST HATEOAS link and related metadata. If responses provide links (for example, a self link to the resource itself) the links provided will include one or more of the properties defined on this link structure.
-
href(optional):
string
The target resource URI. URI RFC3986 or URI Template RFC6570. If the value is set to URI Template, then the
templatedproperty must be set totrue. -
mediaType(optional):
string
Media type, as defined by RFC 2046, describing the link target.
-
method(optional):
string
HTTP method for requesting the target of the link.
Valid values are:
-
OPTIONS- HTTP OPTIONS -
HEAD- HTTP HEAD -
GET- HTTP GET -
POST- HTTP POST -
PUT- HTTP PUT -
PATCH- HTTP PATCH -
DELETE- HTTP DELETE
-
-
profile(optional):
string(uri)
Link to the metadata of the resource, such as JSON-schema, that describes the resource expected when dereferencing the target resource.
-
rel(optional):
string
Name of the link relation that, in addition to the type property, can be used to retrieve link details.
-
templated(optional):
boolean
Boolean flag that specifies the
hrefproperty is a URI or URI Template. The property can be assumed to befalseif the property is not present.
Site expiration settings such as whether sites are automatically taken offline and deleted when the site expires.
Introduced in release 20.3.1.-
object
SiteExpirationSettings
Site expiration related settings, such as enabling or disabling automatic site deactivation and deletion. Site expiration only takes affect if site governance is enabled.
Introduced in release 20.3.1.
Prerender service settings such as whether the prerender service is enabled.
Introduced in release 20.1.2.-
object
PrerenderSettings
Search engine optimization related settings, such as enabling or disabling the pre-render service and configuring crawler and bot user-agents.
Introduced in release 20.1.2.
Restrict site, template, theme and component creation to site administrators.
Introduced in release 20.1.2.-
object
SiteAdminOnlyOperations
Defines the operations restricted to Site Administrators.
Introduced in release 20.1.2.
Specify the minimum security allowed for online sites.
Introduced in release 20.1.2.-
object
SecurityPolicy
The security policy specifies the minimum level of security level a site will be allowed to have. The site will be created with this minimum level, and the site manager/owner can then set a more restrictive security level on the site if they wish. The manager/owner cannot select a security level that is less secure than the values specified on the sites security policy.
objectSite expiration related settings, such as enabling or disabling automatic site deactivation and deletion. Site expiration only takes affect if site governance is enabled.
Introduced in release 20.3.1.-
action(optional):
string
What action to take when the site expires. This can be do nothing. If the site is online the site will remain online. The deactivate action takes the site offline after the site expires. The delete action takes the site offline after the site expires and also deletes the site. The site is deleted using the days after to determine how long after expiration before the site is deleted.
Valid values are:
-
nothing- Site is left online and is not deleted -
deactivate- Site is taken offline when the site expires -
delete- Site is taken offline when the site expires and deleted after a configurable number of days after expiration
-
-
deleteAfter(optional):
integer(int32)
Minimum Value:
3Maximum Value:90Number of days to wait after a site expires before deleting the site. This setting is only used if the action selected is to delete expired sites. This setting can still be set if site deletion is disabled; the setting value will just be ignored.
Introduced in release 20.3.1.
objectSearch engine optimization related settings, such as enabling or disabling the pre-render service and configuring crawler and bot user-agents.
Introduced in release 20.1.2.-
enabled(optional):
boolean
Enable or disable the Prerender Service.
Introduced in release 20.1.2. -
userAgents(optional):
string
Comma-separated list of user-agent product names that, if detected, will cause the client (crawlers and bots) to be redirected to the pre-render generated cached site content. Oracle Content Management has a built in list of crawlers and bots with is combined with this custom user-agent product names.
Introduced in release 20.1.2.
objectDefines the operations restricted to Site Administrators.
Introduced in release 20.1.2.-
componentCreation(optional):
boolean
If true, only site administrators can create components.
Introduced in release 20.1.2. -
siteCreation(optional):
boolean
If true, only site administrators can create sites. Ignored if governance is enabled.
Introduced in release 20.1.2. -
templateCreation(optional):
boolean
If true, only site administrators can create templates.
Introduced in release 20.1.2. -
themeCreation(optional):
boolean
If true, only site administrators can create themes.
Introduced in release 20.1.2.
objectThe security policy specifies the minimum level of security level a site will be allowed to have. The site will be created with this minimum level, and the site manager/owner can then set a more restrictive security level on the site if they wish. The manager/owner cannot select a security level that is less secure than the values specified on the sites security policy.
-
appliesTo(optional):
string
Define which types of users may access a site. Can include all users or be restricted to named users only.
Valid values are:
-
named- Only named users within a specified level can access -
all- All users within a specified level can access
-
-
level(optional):
string
Maximum open security level that can be set on a site.
Valid values are:
-
service- Only service users -
cloud- Only cloud users who can sign in to your domain -
everyone- Anyone without signing in
-
{
"allowSiteCreation":false,
"governanceEnabled":false,
"siteSecurityPolicy":{
"level":"service",
"appliesTo":"named"
},
"siteAdminOnlyOperations":{
"siteCreation":false,
"templateCreation":false,
"themeCreation":false,
"componentCreation":false
},
"prerender":{
"enabled":false,
"userAgents":"AdsBot-Google,AdsBot-Google-Mobile-Apps,AppEngine-Google"
},
"expiration":{
"action":"nothing",
"deleteAfter":30
}
}