Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Soporte ejemplos que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with 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 `add-attachments-to-set` ejemplo, se agrega una imagen a un conjunto que, a continuación, puedes especificar para un caso de soporte en tu AWS cuenta.
```
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 más información sobre la API, consulta [AddAttachmentsToSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/add-attachments-to-set.html)la *Referencia de AWS CLI comandos*.
### `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 `add-communication-to-case` ejemplo, se añaden comunicaciones a un caso de soporte de tu AWS cuenta.
```
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, consulta [AddCommunicationToCase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/add-communication-to-case.html)la *Referencia de AWS CLI comandos*.
### `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 `create-case` ejemplo, se crea un caso de soporte para tu AWS cuenta.
```
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 más información sobre la API, consulta [CreateCase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/create-case.html)la *Referencia de AWS CLI comandos*.
### `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 más información sobre la API, consulte [DescribeAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-attachment.html)la *Referencia de AWS CLI comandos*.
### `describe-cases`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-cases`.
**AWS CLI**
**Descripción de un caso**
El siguiente `describe-cases` ejemplo devuelve información sobre el caso de soporte especificado en tu AWS cuenta.
```
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 más información sobre la API, consulta [DescribeCases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-cases.html)la *Referencia de AWS CLI comandos*.
### `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 `describe-communications` ejemplo, se devuelve la última comunicación del caso de soporte especificado en tu AWS cuenta.
```
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 más información sobre la API, consulta [DescribeCommunications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-communications.html)la *Referencia de AWS CLI comandos*.
### `describe-services`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-services`.
**AWS CLI**
**Para enumerar AWS los servicios y las categorías de servicios**
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 más información sobre la API, consulte [DescribeServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-services.html)la *Referencia de AWS CLI comandos*.
### `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 más información sobre la API, consulte [DescribeSeverityLevels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-severity-levels.html)la *Referencia de AWS CLI comandos*.
### `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 más información sobre la API, consulte [DescribeTrustedAdvisorCheckRefreshStatuses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-trusted-advisor-check-refresh-statuses.html)la *Referencia de AWS CLI comandos*.
### `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 más información sobre la API, consulte [DescribeTrustedAdvisorCheckResult](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-trusted-advisor-check-result.html)la *Referencia de AWS CLI comandos*.
### `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 más información sobre la API, consulte [DescribeTrustedAdvisorCheckSummaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-trusted-advisor-check-summaries.html)la *Referencia de AWS CLI comandos*.
### `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 AWS de Trusted Advisor disponibles**
El siguiente `describe-trusted-advisor-checks` ejemplo muestra los cheques de Trusted Advisor disponibles en su AWS cuenta. 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 más información sobre la API, consulte [DescribeTrustedAdvisorChecks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/describe-trusted-advisor-checks.html)la *Referencia de AWS CLI comandos*.
### `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 AWS de Trusted Advisor**
En el siguiente `refresh-trusted-advisor-check` ejemplo, se actualiza la comprobación de Amazon S3 Bucket Permissions Trusted Advisor de su AWS cuenta.
```
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 obtener más información sobre la API, consulte [RefreshTrustedAdvisorCheck](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/refresh-trusted-advisor-check.html)la *Referencia de AWS CLI comandos*.
### `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**
El siguiente `resolve-case` ejemplo resuelve un caso de soporte en tu AWS cuenta.
```
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 más información sobre la API, consulta [ResolveCase](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/support/resolve-case.html)la *Referencia de AWS CLI comandos*.