Creating a Scope
Scopes can be created, by means of the REST API.
Scopes are created by means of the
POST /pools/default/buckets/<bucket_name>/scopes/ HTTP method and URI.
The curl syntax is as follows:
curl -X POST -v -u [admin]:[password] http://<hostname-or-ip>:8091/pools/default/buckets/<bucket-name>/scopes -d name=<scope-name>
<bucket-name> path-parameter specifies the bucket within which the new scope is to be created.
name parameter specifies the name of the scope to be created: this name cannot subsequently be changed.
Failure to authenticate gives
A malformed URI fails with
404 Object Not Found.
If the scope-name is improperly specified, a notification such as
"name":"Length must be in range from 1 to 30" or
"name":"Can only contain characters A-Z, a-z, 0-9 and the following symbols _ - %" is displayed.
See Naming for Scopes and Collections, for an account of naming conventions.
The following call creates a scope named
my_scope in the bucket
curl -X POST -v -u Administrator:password \ http://10.143.210.101:8091/pools/default/buckets/testBucket/scopes \ -d name=my_scope
If successful, the call returns a
uid, such as the following: