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 parent
Describes where the parent resource can be read. Equivalent to an up
link, this link provides the link to the parent resource, such as the collection resource that contains a singular resource.self
Describes 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. canonical
Describes 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. edit
Describes where the resource can be edited. Used on singular resources to indicate where a patch can be performed to edit an existing resource. edit-form
Describes 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. describedBy
Describes 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
,excludeLinks
andexpand
query parameters.The following representations are supported with the
return
query parameter:Representation Description representation
Full resource representation includes all properties and links and expands most relationships. default
Default resource representation includes most properties and links. basic
Basic resource representation includes some properties and some links. minimal
Minimal 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]
object
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.
-
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.
array
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
REST 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
templated
property 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
href
property is a URI or URI Template. The property can be assumed to befalse
if 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.
object
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.-
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:
3
Maximum Value:90
Number 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.
object
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.-
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.
object
Defines 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.
object
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.
-
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
}
}