PUT /manage/v2/credentials/properties

Summary

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 the manage-admin role, or the following privilege:

http://marklogic.com/xdmp/privileges/manage-admin

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). 
    
Powered by MarkLogic Server | Terms of Use | Privacy Policy