# Ejemplos del Cost Explorer Service que utilizan la AWS CLI
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando la AWS Command Line Interface con Cost Explorer Service.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `get-cost-and-usage`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-cost-and-usage`.
**AWS CLI**
**Recuperación del uso de una cuenta en S3 durante el mes de septiembre de 2017**
En el siguiente ejemplo de `get-cost-and-usage`, se recupera el uso de una cuenta en S3 durante el mes de septiembre de 2017.
```
aws ce get-cost-and-usage \
--time-period Start=2017-09-01,End=2017-10-01 \
--granularity MONTHLY \
--metrics "BlendedCost" "UnblendedCost" "UsageQuantity" \
--group-by Type=DIMENSION,Key=SERVICE Type=TAG,Key=Environment \
--filter file://filters.json
```
Contenido de `filters.json`:
```
{
"Dimensions": {
"Key": "SERVICE",
"Values": [
"Amazon Simple Storage Service"
]
}
}
```
Salida:
```
{
"GroupDefinitions": [
{
"Type": "DIMENSION",
"Key": "SERVICE"
},
{
"Type": "TAG",
"Key": "Environment"
}
],
"ResultsByTime": [
{
"Estimated": false,
"TimePeriod": {
"Start": "2017-09-01",
"End": "2017-10-01"
},
"Total": {},
"Groups": [
{
"Keys": [
"Amazon Simple Storage Service",
"Environment$"
],
"Metrics": {
"BlendedCost": {
"Amount": "40.3527508453",
"Unit": "USD"
},
"UnblendedCost": {
"Amount": "40.3543773134",
"Unit": "USD"
},
"UsageQuantity": {
"Amount": "9312771.098461578",
"Unit": "N/A"
}
}
},
{
"Keys": [
"Amazon Simple Storage Service",
"Environment$Dev"
],
"Metrics": {
"BlendedCost": {
"Amount": "0.2682364644",
"Unit": "USD"
},
"UnblendedCost": {
"Amount": "0.2682364644",
"Unit": "USD"
},
"UsageQuantity": {
"Amount": "22403.4395271182",
"Unit": "N/A"
}
}
}
]
}
]
}
```
+ Para obtener detalles sobre la API, consulte [GetCostAndUsage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-cost-and-usage.html) en la *Referencia de comandos de la AWS CLI*.
### `get-dimension-values`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-dimension-values`.
**AWS CLI**
**Recuperación de las etiquetas de la dimensión SERVICE con el valor Elastic**
En este ejemplo, se recuperan las etiquetas de la dimensión SERVICE, con un valor Elastic del 1 de enero al 18 de mayo de 2017.
Comando:
```
aws ce get-dimension-values --search-string Elastic --time-period Start=2017-01-01,End=2017-05-18 --dimension SERVICE
```
Salida:
```
{
"TotalSize": 6,
"DimensionValues": [
{
"Attributes": {},
"Value": "Amazon ElastiCache"
},
{
"Attributes": {},
"Value": "EC2 - Other"
},
{
"Attributes": {},
"Value": "Amazon Elastic Compute Cloud - Compute"
},
{
"Attributes": {},
"Value": "Amazon Elastic Load Balancing"
},
{
"Attributes": {},
"Value": "Amazon Elastic MapReduce"
},
{
"Attributes": {},
"Value": "Amazon Elasticsearch Service"
}
],
"ReturnSize": 6
}
```
+ Para obtener detalles sobre la API, consulte [GetDimensionValues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-dimension-values.html) en la *Referencia de comandos de la AWS CLI*.
### `get-reservation-coverage`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-reservation-coverage`.
**AWS CLI**
**Recuperación de la cobertura de reservas para las instancias t2.nano de EC2 en la región us-east-1**
En este ejemplo, se recupera la cobertura de reservas para las instancias t2.nano de EC2 en la región us-east-1 de julio a septiembre de 2017.
Comando:
```
aws ce get-reservation-coverage --time-period Start=2017-07-01,End=2017-10-01 --group-by Type=Dimension,Key=REGION --filter file://filters.json
```
filters.json:
```
{
"And": [
{
"Dimensions": {
"Key": "INSTANCE_TYPE",
"Values": [
"t2.nano"
]
},
"Dimensions": {
"Key": "REGION",
"Values": [
"us-east-1"
]
}
}
]
}
```
Salida:
```
{
"TotalSize": 6,
"DimensionValues": [
{
"Attributes": {},
"Value": "Amazon ElastiCache"
},
{
"Attributes": {},
"Value": "EC2 - Other"
},
{
"Attributes": {},
"Value": "Amazon Elastic Compute Cloud - Compute"
},
{
"Attributes": {},
"Value": "Amazon Elastic Load Balancing"
},
{
"Attributes": {},
"Value": "Amazon Elastic MapReduce"
},
{
"Attributes": {},
"Value": "Amazon Elasticsearch Service"
}
],
"ReturnSize": 6
}
```
+ Para obtener detalles sobre la API, consulte [GetReservationCoverage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-reservation-coverage.html) en la *Referencia de comandos de la AWS CLI*.
### `get-reservation-purchase-recommendation`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-reservation-purchase-recommendation`.
**AWS CLI**
**Obtención de recomendaciones de reserva para las RI de EC2 con pago inicial parcial con un plazo de tres años**
En el siguiente ejemplo de `get-reservation-purchase-recommendation`, se recuperan las recomendaciones para las instancias de EC2 con pago inicial parcial con un plazo de tres años, en función de los últimos 60 días de uso de EC2.
```
aws ce get-reservation-purchase-recommendation \
--service "Amazon Redshift" \
--lookback-period-in-days SIXTY_DAYS \
--term-in-years THREE_YEARS \
--payment-option PARTIAL_UPFRONT
```
Salida:
```
{
"Recommendations": [],
"Metadata": {
"GenerationTimestamp": "2018-08-08T15:20:57Z",
"RecommendationId": "00d59dde-a1ad-473f-8ff2-iexample3330b"
}
}
```
+ Para obtener detalles sobre la API, consulte [GetReservationPurchaseRecommendation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-reservation-purchase-recommendation.html) en la *Referencia de comandos de la AWS CLI*.
### `get-reservation-utilization`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-reservation-utilization`.
**AWS CLI**
**Recuperación de la utilización de la reserva para su cuenta**
En el siguiente ejemplo de `get-reservation-utilization`, se recupera el uso de la RI en todos los tipos de instancias t2.nano entre el 1 de marzo de 2018 y el 1 de agosto de 2018 para la cuenta.
```
aws ce get-reservation-utilization \
--time-period Start=2018-03-01,End=2018-08-01 \
--filter file://filters.json
```
Contenido de `filters.json`:
```
{
"Dimensions": {
"Key": "INSTANCE_TYPE",
"Values": [
"t2.nano"
]
}
}
```
Salida:
```
{
"Total": {
"TotalAmortizedFee": "0",
"UtilizationPercentage": "0",
"PurchasedHours": "0",
"NetRISavings": "0",
"TotalActualHours": "0",
"AmortizedRecurringFee": "0",
"UnusedHours": "0",
"TotalPotentialRISavings": "0",
"OnDemandCostOfRIHoursUsed": "0",
"AmortizedUpfrontFee": "0"
},
"UtilizationsByTime": []
}
```
+ Para obtener detalles sobre la API, consulte [GetReservationUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-reservation-utilization.html) en la *Referencia de comandos de la AWS CLI*.
### `get-tags`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-tags`.
**AWS CLI**
**Recuperación de las claves y los valores de una etiqueta de asignación de costes**
En este ejemplo, se recuperan todas las etiquetas de asignación de costes con la clave Project y un valor que contiene secretProject.
Comando:
```
aws ce get-tags --search-string secretProject --time-period Start=2017-01-01,End=2017-05-18 --tag-key Project
```
Salida:
```
{
"ReturnSize": 2,
"Tags": [
"secretProject1",
"secretProject2"
],
"TotalSize": 2
}
```
+ Para obtener detalles sobre la API, consulte [GetTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ce/get-tags.html) en la *Referencia de comandos de la AWS CLI*.