# Soporte Ejemplos de usando AWS CLI
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Soporte.
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
### `add-attachments-to-set`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-attachments-to-set`.
**AWS CLI**
**Para añadir un archivo adjunto a un conjunto**
En el siguiente ejemplo de `add-attachments-to-set`, se agrega una imagen a un conjunto que, a continuación, puede especificar para un caso de soporte en su cuenta de AWS.
```
aws support add-attachments-to-set \
--attachment-set-id "as-2f5a6faa2a4a1e600-mu-nk5xQlBr70-G1cUos5LZkd38KOAHZa9BMDVzNEXAMPLE" \
--attachments fileName=troubleshoot-screenshot.png,data=base64-encoded-string
```
Salida:
```
{
"attachmentSetId": "as-2f5a6faa2a4a1e600-mu-nk5xQlBr70-G1cUos5LZkd38KOAHZa9BMDVzNEXAMPLE",
"expiryTime": "2020-05-14T17:04:40.790+0000"
}
```
Para obtener más información, consulte [Administración de casos](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) en la *Guía del usuario de soporte de AWS*.
+ Para obtener detalles sobre la API, consulte [AddAttachmentsToSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/add-attachments-to-set.html) en la *Referencia de comandos de la AWS CLI*.
### `add-communication-to-case`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-communication-to-case`.
**AWS CLI**
**Para agregar una comunicación a un caso**
En el siguiente ejemplo de `add-communication-to-case`, se agregan comunicaciones a un caso de soporte en su cuenta de AWS.
```
aws support add-communication-to-case \
--case-id "case-12345678910-2013-c4c1d2bf33c5cf47" \
--communication-body "I'm attaching a set of images to this case." \
--cc-email-addresses "myemail@example.com" \
--attachment-set-id "as-2f5a6faa2a4a1e600-mu-nk5xQlBr70-G1cUos5LZkd38KOAHZa9BMDVzNEXAMPLE"
```
Salida:
```
{
"result": true
}
```
Para obtener más información, consulte [Administración de casos](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) en la *Guía del usuario de soporte de AWS*.
+ Para obtener información sobre la API, consulte [AddCommunicationToCase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/add-communication-to-case.html) en la *Referencia de comandos de la AWS CLI*.
### `create-case`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-case`.
**AWS CLI**
**Creación de un caso**
En el siguiente ejemplo de `create-case` se crea un caso de soporte para su cuenta de AWS.
```
aws support create-case \
--category-code "using-aws" \
--cc-email-addresses "myemail@example.com" \
--communication-body "I want to learn more about an AWS service." \
--issue-type "technical" \
--language "en" \
--service-code "general-info" \
--severity-code "low" \
--subject "Question about my account"
```
Salida:
```
{
"caseId": "case-12345678910-2013-c4c1d2bf33c5cf47"
}
```
Para obtener más información, consulte [Administración de casos](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) en la *Guía del usuario de soporte de AWS*.
+ Para obtener información sobre la API, consulte [CreateCase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/create-case.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-attachment`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-attachment`.
**AWS CLI**
**Descripción de un archivo adjunto**
El siguiente ejemplo de `describe-attachment` devuelve información sobre el archivo adjunto con el ID especificado.
```
aws support describe-attachment \
--attachment-id "attachment-KBnjRNrePd9D6Jx0-Mm00xZuDEaL2JAj_0-gJv9qqDooTipsz3V1Nb19rCfkZneeQeDPgp8X1iVJyHH7UuhZDdNeqGoduZsPrAhyMakqlc60-iJjL5HqyYGiT1FG8EXAMPLE"
```
Salida:
```
{
"attachment": {
"fileName": "troubleshoot-screenshot.png",
"data": "base64-blob"
}
}
```
Para obtener más información, consulte [Administración de casos](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) en la *Guía del usuario de soporte de AWS*.
+ Para obtener información sobre la API, consulte [DescribeAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-attachment.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-cases`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-cases`.
**AWS CLI**
**Descripción de un caso**
En el siguiente ejemplo de `describe-cases` se devuelve información sobre el caso de soporte especificado en su cuenta de AWS.
```
aws support describe-cases \
--display-id "1234567890" \
--after-time "2020-03-23T21:31:47.774Z" \
--include-resolved-cases \
--language "en" \
--no-include-communications \
--max-item 1
```
Salida:
```
{
"cases": [
{
"status": "resolved",
"ccEmailAddresses": [],
"timeCreated": "2020-03-23T21:31:47.774Z",
"caseId": "case-12345678910-2013-c4c1d2bf33c5cf47",
"severityCode": "low",
"language": "en",
"categoryCode": "using-aws",
"serviceCode": "general-info",
"submittedBy": "myemail@example.com",
"displayId": "1234567890",
"subject": "Question about my account"
}
]
}
```
Para obtener más información, consulte [Administración de casos](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) en la *Guía del usuario de soporte de AWS*.
+ Para obtener información sobre la API, consulte [DescribeCases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-cases.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-communications`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-communications`.
**AWS CLI**
**Descripción de la última comunicación de un caso**
En el siguiente ejemplo de `describe-communications` se devuelve la última comunicación del caso de soporte especificado en su cuenta de AWS.
```
aws support describe-communications \
--case-id "case-12345678910-2013-c4c1d2bf33c5cf47" \
--after-time "2020-03-23T21:31:47.774Z" \
--max-item 1
```
Salida:
```
{
"communications": [
{
"body": "I want to learn more about an AWS service.",
"attachmentSet": [],
"caseId": "case-12345678910-2013-c4c1d2bf33c5cf47",
"timeCreated": "2020-05-12T23:12:35.000Z",
"submittedBy": "Amazon Web Services"
}
],
"NextToken": "eyJuZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQEXAMPLE=="
}
```
Para obtener más información, consulte [Administración de casos](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) en la *Guía del usuario de soporte de AWS*.
+ Para obtener información sobre la API, consulte [DescribeCommunications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-communications.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-services`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-services`.
**AWS CLI**
**Creación de una lista de los servicios y las categorías de servicios de AWS**
En el siguiente ejemplo de `describe-services` se enumeran las categorías de servicios disponibles para solicitar información general.
```
aws support describe-services \
--service-code-list "general-info"
```
Salida:
```
{
"services": [
{
"code": "general-info",
"name": "General Info and Getting Started",
"categories": [
{
"code": "charges",
"name": "How Will I Be Charged?"
},
{
"code": "gdpr-queries",
"name": "Data Privacy Query"
},
{
"code": "reserved-instances",
"name": "Reserved Instances"
},
{
"code": "resource",
"name": "Where is my Resource?"
},
{
"code": "using-aws",
"name": "Using AWS & Services"
},
{
"code": "free-tier",
"name": "Free Tier"
},
{
"code": "security-and-compliance",
"name": "Security & Compliance"
},
{
"code": "account-structure",
"name": "Account Structure"
}
]
}
]
}
```
Para obtener más información, consulte [Administración de casos](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) en la *Guía del usuario de soporte de AWS*.
+ Para obtener información sobre la API, consulte [DescribeServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-services.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-severity-levels`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-severity-levels`.
**AWS CLI**
**Creación de una lista de los niveles de gravedad disponibles**
En el siguiente ejemplo de `describe-severity-levels` se enumeran los niveles de gravedad disponibles para un caso de soporte.
```
aws support describe-severity-levels
```
Salida:
```
{
"severityLevels": [
{
"code": "low",
"name": "Low"
},
{
"code": "normal",
"name": "Normal"
},
{
"code": "high",
"name": "High"
},
{
"code": "urgent",
"name": "Urgent"
},
{
"code": "critical",
"name": "Critical"
}
]
}
```
Para obtener más información, consulte [Elección de la gravedad](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html#choosing-severity) en la *Guía del usuario de soporte de AWS*.
+ Para obtener información sobre la API, consulte [DescribeSeverityLevels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-severity-levels.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-trusted-advisor-check-refresh-statuses`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-trusted-advisor-check-refresh-statuses`.
**AWS CLI**
**Para enumerar los estados de actualización de las comprobaciones de AWS Trusted Advisor**
En el siguiente ejemplo de `describe-trusted-advisor-check-refresh-statuses`, se muestran los estados de actualización de dos comprobaciones de Trusted Advisor: Permisos de bucket de Amazon S3 y Uso de IAM.
```
aws support describe-trusted-advisor-check-refresh-statuses \
--check-id "Pfx0RwqBli" "zXCkfM1nI3"
```
Salida:
```
{
"statuses": [
{
"checkId": "Pfx0RwqBli",
"status": "none",
"millisUntilNextRefreshable": 0
},
{
"checkId": "zXCkfM1nI3",
"status": "none",
"millisUntilNextRefreshable": 0
}
]
}
```
Para obtener más información, consulte [AWS Trusted Advisor](https://docs.aws.amazon.com/awssupport/latest/user/trusted-advisor.html) en la *Guía del usuario de AWS Support*.
+ Para obtener información sobre la API, consulte [DescribeTrustedAdvisorCheckRefreshStatuses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-trusted-advisor-check-refresh-statuses.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-trusted-advisor-check-result`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-trusted-advisor-check-result`.
**AWS CLI**
**Para enumerar los resultados de una comprobación de AWS Trusted Advisor**
En el siguiente ejemplo de `describe-trusted-advisor-check-result`, se muestran los resultados de la comprobación de Uso de IAM.
```
aws support describe-trusted-advisor-check-result \
--check-id "zXCkfM1nI3"
```
Salida:
```
{
"result": {
"checkId": "zXCkfM1nI3",
"timestamp": "2020-05-13T21:38:05Z",
"status": "ok",
"resourcesSummary": {
"resourcesProcessed": 1,
"resourcesFlagged": 0,
"resourcesIgnored": 0,
"resourcesSuppressed": 0
},
"categorySpecificSummary": {
"costOptimizing": {
"estimatedMonthlySavings": 0.0,
"estimatedPercentMonthlySavings": 0.0
}
},
"flaggedResources": [
{
"status": "ok",
"resourceId": "47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZEXAMPLE",
"isSuppressed": false
}
]
}
}
```
Para obtener más información, consulte [AWS Trusted Advisor](https://docs.aws.amazon.com/awssupport/latest/user/trusted-advisor.html) en la *Guía del usuario de AWS Support*.
+ Para obtener información sobre la API, consulte [DescribeTrustedAdvisorCheckResult](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-trusted-advisor-check-result.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-trusted-advisor-check-summaries`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-trusted-advisor-check-summaries`.
**AWS CLI**
**Para enumerar los resúmenes de las comprobaciones de AWS Trusted Advisor**
En el siguiente ejemplo de `describe-trusted-advisor-check-summaries`, se muestran los resultados de dos comprobaciones de Trusted Advisor: Permisos de bucket de Amazon S3 y Uso de IAM.
```
aws support describe-trusted-advisor-check-summaries \
--check-ids "Pfx0RwqBli" "zXCkfM1nI3"
```
Salida:
```
{
"summaries": [
{
"checkId": "Pfx0RwqBli",
"timestamp": "2020-05-13T21:38:12Z",
"status": "ok",
"hasFlaggedResources": true,
"resourcesSummary": {
"resourcesProcessed": 44,
"resourcesFlagged": 0,
"resourcesIgnored": 0,
"resourcesSuppressed": 0
},
"categorySpecificSummary": {
"costOptimizing": {
"estimatedMonthlySavings": 0.0,
"estimatedPercentMonthlySavings": 0.0
}
}
},
{
"checkId": "zXCkfM1nI3",
"timestamp": "2020-05-13T21:38:05Z",
"status": "ok",
"hasFlaggedResources": true,
"resourcesSummary": {
"resourcesProcessed": 1,
"resourcesFlagged": 0,
"resourcesIgnored": 0,
"resourcesSuppressed": 0
},
"categorySpecificSummary": {
"costOptimizing": {
"estimatedMonthlySavings": 0.0,
"estimatedPercentMonthlySavings": 0.0
}
}
}
]
}
```
Para obtener más información, consulte [AWS Trusted Advisor](https://docs.aws.amazon.com/awssupport/latest/user/trusted-advisor.html) en la *Guía del usuario de AWS Support*.
+ Para obtener información sobre la API, consulte [DescribeTrustedAdvisorCheckSummaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-trusted-advisor-check-summaries.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-trusted-advisor-checks`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-trusted-advisor-checks`.
**AWS CLI**
**Para enumerar las comprobaciones de AWS Trusted Advisor disponibles**
En el siguiente ejemplo de `describe-trusted-advisor-checks`, se enumeran las comprobaciones de Trusted Advisor disponibles en su cuenta de AWS. Esta información incluye el nombre, el ID, la descripción, la categoría y los metadatos del cheque. Tenga en cuenta que el resultado se abrevia para que se pueda leer.
```
aws support describe-trusted-advisor-checks \
--language "en"
```
Salida:
```
{
"checks": [
{
"id": "zXCkfM1nI3",
"name": "IAM Use",
"description": "Checks for your use of AWS Identity and Access Management (IAM). You can use IAM to create users, groups, and roles in AWS, and you can use permissions to control access to AWS resources. \n
\n
\nAlert Criteria
\nYellow: No IAM users have been created for this account.\n
\n
\nRecommended Action
\nCreate one or more IAM users and groups in your account. You can then create additional users whose permissions are limited to perform specific tasks in your AWS environment. For more information, see Getting Started. \n
\nAdditional Resources
\nWhat Is IAM?",
"category": "security",
"metadata": []
}
]
}
```
Para obtener más información, consulte [AWS Trusted Advisor](https://docs.aws.amazon.com/awssupport/latest/user/trusted-advisor.html) en la *Guía del usuario de AWS Support*.
+ Para obtener información sobre la API, consulte [DescribeTrustedAdvisorChecks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-trusted-advisor-checks.html) en la *Referencia de comandos de la AWS CLI*.
### `refresh-trusted-advisor-check`
En el siguiente ejemplo de código, se muestra cómo utilizar `refresh-trusted-advisor-check`.
**AWS CLI**
**Para actualizar una comprobación de AWS Trusted Advisor**
En el siguiente ejemplo de `refresh-trusted-advisor-check`, se actualiza la comprobación Permisos del bucket de Amazon S3 de Trusted Advisor en su cuenta de AWS.
```
aws support refresh-trusted-advisor-check \
--check-id "Pfx0RwqBli"
```
Salida:
```
{
"status": {
"checkId": "Pfx0RwqBli",
"status": "enqueued",
"millisUntilNextRefreshable": 3599992
}
}
```
Para obtener más información, consulte [AWS Trusted Advisor](https://docs.aws.amazon.com/awssupport/latest/user/trusted-advisor.html) en la *Guía del usuario de AWS Support*.
+ Para ver los detalles de la API, consulte [RefreshTrustedAdvisorCheck](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/refresh-trusted-advisor-check.html) en la *Referencia de comandos de la AWS CLI*.
### `resolve-case`
En el siguiente ejemplo de código, se muestra cómo utilizar `resolve-case`.
**AWS CLI**
**Resolución de un caso de soporte**
En el siguiente ejemplo de `resolve-case` se resuelve un caso de soporte en su cuenta de AWS.
```
aws support resolve-case \
--case-id "case-12345678910-2013-c4c1d2bf33c5cf47"
```
Salida:
```
{
"finalCaseStatus": "resolved",
"initialCaseStatus": "work-in-progress"
}
```
Para obtener más información, consulte [Administración de casos](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) en la *Guía del usuario de soporte de AWS*.
+ Para obtener información sobre la API, consulte [ResolveCase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/resolve-case.html) en la *Referencia de comandos de la AWS CLI*.