AWS credentials API - GET credentials
Gets the configuration of the specified AWS credentials.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/config/v1/aws/credentials/{id} |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/aws/credentials/{id} | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/aws/credentials/{id} |
Authentication
To execute this request, you need an access token with ReadConfig
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
id | string | The ID of the specified AWS credentials configuration. | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | Aws | Success |
Response body objects
The AwsCredentialsConfig
object
Configuration of an AWS credentials.
Element | Type | Description |
---|---|---|
authenticationData | Aws | A credentials for the AWS authentication. |
connectionStatus | string | The status of the connection to the AWS environment.
|
id | string | The unique ID of the credentials. |
label | string | The name of the credentials. |
metadata | Configuration | Metadata useful for debugging |
partitionType | string | The type of the AWS partition. |
supportingServicesToMonitor | Aws | Deprecated. To manage services use /aws/credentials/{id}/services operation. Built-in services are not supported here. A list of AWS services to be monitored. Available services are listed by /aws/supportedServices operation. For each service, a list of metrics and dimensions can be specified. A list of supported metrics and dimensions for a given service can be checked in documentation. List of metrics can be skipped (set to null), resulting in recommended (default) set of metrics and dimensions being chosen for monitoring. |
taggedOnly | boolean | Monitor only resources which have specified AWS tags ( |
tagsToMonitor | Aws | A list of AWS tags to be monitored. You can specify up to 10 tags. Only applicable when the taggedOnly parameter is set to |
The AwsAuthenticationData
object
A credentials for the AWS authentication.
Element | Type | Description |
---|---|---|
keyBasedAuthentication | Key | Deprecated. The credentials for the key-based authentication. |
roleBasedAuthentication | Role | The credentials for the role-based authentication. |
type | string | The type of the authentication: role-based or key-based. |
The KeyBasedAuthentication
object
Deprecated. The credentials for the key-based authentication.
Element | Type | Description |
---|---|---|
accessKey | string | The ID of the access key. |
secretKey | string | The secret access key. |
The RoleBasedAuthentication
object
The credentials for the role-based authentication.
Element | Type | Description |
---|---|---|
accountId | string | The ID of the Amazon account. |
externalId | string | The external ID token for setting an IAM role. You can obtain it with the |
iamRole | string | The IAM role to be used by Dynatrace to get monitoring data. |
The ConfigurationMetadata
object
Metadata useful for debugging
Element | Type | Description |
---|---|---|
clusterVersion | string | Dynatrace version. |
configurationVersions | integer[] | A sorted list of the version numbers of the configuration. |
currentConfigurationVersions | string[] | A sorted list of version numbers of the configuration. |
The AwsSupportingServiceConfig
object
A service to be monitored.
Element | Type | Description |
---|---|---|
monitoredMetrics | Aws | A list of metrics to be monitored for this service. If the list is null then recommended list of metrics for this service will be monitored. |
name | string | The name of the service. Valid supported service names can be discovered using /aws/supportedServices restAPI |
The AwsSupportingServiceMetric
object
A metric of service to be monitored.
Element | Type | Description |
---|---|---|
dimensions | string[] | A list of metric's dimensions names. |
name | string | The name of the metric of the service. |
statistic | string | The statistic (aggregation) to be used for the metric. AVG_MIN_MAX value is 3 statistics at once: AVERAGE, MINIMUM and MAXIMUM |
The AwsConfigTag
object
An AWS tag of the resource to be monitored.
Element | Type | Description |
---|---|---|
name | string | The key of the AWS tag. |
value | string | The value of the AWS tag. |
Response body JSON model
{
"authenticationData": {
"keyBasedAuthentication": {
"accessKey": "string",
"secretKey": "string"
},
"roleBasedAuthentication": {
"accountId": "string",
"externalId": "string",
"iamRole": "string"
},
"type": "KEYS"
},
"connectionStatus": "CONNECTED",
"id": "string",
"label": "string",
"metadata": {
"clusterVersion": "1.192.1",
"configurationVersions": [
4,
2
],
"currentConfigurationVersions": [
"1.0.4",
"1.23"
]
},
"partitionType": "AWS_CN",
"supportingServicesToMonitor": [
{
"monitoredMetrics": [
{
"dimensions": [
"string"
],
"name": "string",
"statistic": "AVERAGE"
}
],
"name": "string"
}
],
"taggedOnly": true,
"tagsToMonitor": [
{
"name": "string",
"value": "string"
}
]
}