MarkLogic 10 Product Documentation
PUT /manage/v2/credentials/propertiesSummary
This resource address sets the credentials used to access external services,
such as Amazon Web Services (AWS).
URL Parameters |
format |
The format of the posted data. Can be either
json or xml (default). This value overrides the Accept header if
both are present. |
type |
The type of credentials to be creaeted.
If not specified, the default is aws . |
Request Headers |
Accept |
The expected MIME type of the request body. If
the format parameter is present, it takes precedence over the Accept header. |
Content-type |
The MIME type of the data in the request
body. Depending upon the value of the format parameter or Accept header, one of
application/xml , application/json , or text/html . |
Response Headers |
Content-type |
The MIME type of the data in the response
body. Depending upon the value of the format parameter or Accept header, one of
application/xml , application/json , or text/html .
|
Response
Upon success, MarkLogic Server returns a status code 201 (Created). If the
payload is malformed or the alert does not exist, a status code of 400 (Bad Request) is
returned. A status code of 401 (Unauthorized) is returned if the user does not have the
necessary privileges.
Required Privileges
This operation requires one of the following:
- the
manage-admin
and security
role
- the following privileges:
http://marklogic.com/xdmp/privileges/manage
http://marklogic.com/xdmp/privileges/manage-admin
and/or
http://marklogic.com/xdmp/privileges/credentials-set-aws
http://marklogic.com/xdmp/privileges/credentials-set-azure
Usage Notes
The structure of the output returned from
this REST API is as follows:
aws
Credentials
This is a complex structure with the following children:
access-key
The Amazon Web Services access key.
secret-key
The Amazon Web Services secret key.
session-token
The Amazon Web Services session token.
azure
Credentials
This is a complex structure with the following children:
storage-account
The Microsoft Azure storage account name.
storage-key
The Microsoft Azure storage access key.
Example
curl -X PUT --digest -u admin:admin -H "Content-type: application/json" \
-d '{
"type": "aws",
"access-key": "AWS-ACCESS-KEY",
"secret-key": "SECRET-KEY"
}' \
http://localhost:8002/manage/v2/credentials/properties
==> Sets the access and secret keys used to access Amazon Web Services (AWS).
Copyright © 2024 MarkLogic Corporation. MARKLOGIC is a
registered trademark of MarkLogic Corporation.