Skip to main content

Create: AWS type

Description

Use a HTTP POST request to create a AWS credential.

Request

HTTP Method: POST

ParameterDescription
nameName of the credential.
modeDescribes the type of credential (AWS)
team_idID of Tines Team where the credential will be located.
folder_idOptional ID of folder to which the credential will be located
read_accessOptional Control where this credential can be used (TEAM, GLOBAL). default: TEAM
descriptionOptional Description of the credential. default: "" (empty string)
aws_authentication_typeThe authentication method with AWS, key-based-access or role-based-access(KEY,ROLE)
aws_access_keyThe access key from your AWS Security Credentials
aws_secret_keyThe access secret from your AWS Security Credentials
aws_assumed_role_arnRequired for role-based-access The ARN of the role you wish to assume, e.g.: arn:aws:iam::123456789012:role/write-access-role
aws_assumed_role_external_idOptional The external ID to be used when making the request

Sample request

curl -X POST \
https://<tenant-domain>/api/v1/user_credentials \
-H 'content-type: application/json' \
-H 'x-user-email: <email-address>' \
-H 'x-user-token: <api-token>' \
-d '{
"name": "foo",
"value": "bar",
"mode": "AWS",
"team_id": 2,
"aws_authentication_type": "KEY",
"aws_access_key": "v_access_key",
"aws_secret_key": "v_secret_key"
}'

Response

A successful request will return a JSON object describing the created credential.

Field description

ParameterDescription
idcredential ID.
nameName of the credential.
modeDescribes the type of credential (TEXT, JWT, OAUTH, AWS, MTLS, HTTP_REQUEST_AGENT)
team_idID of team to which the credential belongs.
folder_idID of folder to which the credential belongs.
read_accessControl where this credential can be used.
descriptionDescription of the credential.
slugAn underscored representation of the credential name
created_atISO 8601 Timestamp representing date and time the credential was created.
updated_atISO 8601 Timestamp representing date and time the credential was last updated.

Sample response

{
"id": 1,
"name": "tines_api_credential",
"mode": "AWS",
"team_id": 2,
"folder_id": 1,
"read_access": "TEAM",
"slug": "tines_api_credential",
"created_at": "2021-03-26T12:34:16.540Z",
"updated_at": "2021-03-26T12:34:16.540Z",
"description": ""
}