AWS Support ejemplos que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

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.

AWS Support 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 AWS Support.

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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

El siguiente ejemplo de código muestra cómo usarloadd-attachments-to-set.

AWS CLI

Para añadir un adjunto a un conjunto

En el siguiente add-attachments-to-set ejemplo, se agrega una imagen a un conjunto que, a continuación, puede especificar para un caso de soporte en su 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 en la Guía del usuario de soporte de AWS .

  • Para API obtener más información, consulta AddAttachmentsToSetla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloadd-communication-to-case.

AWS CLI

Para añadir una comunicación a un caso

En el siguiente add-communication-to-case ejemplo, se agregan 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 en la Guía del usuario de soporte de AWS .

El siguiente ejemplo de código muestra cómo usarlocreate-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 en la Guía del usuario de soporte de AWS .

  • Para API obtener más información, consulte CreateCasela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-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 en la Guía del usuario de soporte de AWS .

  • Para API obtener más información, consulte DescribeAttachmentla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-cases.

AWS CLI

Descripción de un caso

En el siguiente describe-cases ejemplo, se devuelve información sobre el caso de asistencia especificado en su 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 en la Guía del usuario de soporte de AWS .

  • Para API obtener más información, consulte DescribeCasesla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-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 su 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 en la Guía del usuario de soporte de AWS .

El siguiente ejemplo de código muestra cómo usarlodescribe-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 en la Guía del usuario de soporte de AWS .

  • Para API obtener más información, consulte DescribeServicesla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-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 en la Guía del usuario de soporte de AWS .

El siguiente ejemplo de código muestra cómo usarlodescribe-trusted-advisor-check-refresh-statuses.

AWS CLI

Para enumerar los estados de actualización de las comprobaciones de AWS Trusted Advisor

El siguiente describe-trusted-advisor-check-refresh-statuses ejemplo muestra los estados de actualización de dos comprobaciones de Trusted Advisor: Amazon S3 Bucket Permissions y IAM Use.

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 en la Guía del usuario de AWS Support.

El siguiente ejemplo de código muestra cómo usarlodescribe-trusted-advisor-check-result.

AWS CLI

Para enumerar los resultados de una comprobación de AWS Trusted Advisor

El siguiente describe-trusted-advisor-check-result ejemplo muestra los resultados de la comprobación de IAM uso.

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 en la Guía del usuario de AWS Support.

El siguiente ejemplo de código muestra cómo usarlodescribe-trusted-advisor-check-summaries.

AWS CLI

Para enumerar los resúmenes de las comprobaciones de AWS Trusted Advisor

El siguiente describe-trusted-advisor-check-summaries ejemplo muestra los resultados de dos comprobaciones de Trusted Advisor: Amazon S3 Bucket Permissions y IAM Use.

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 en la Guía del usuario de AWS Support.

El siguiente ejemplo de código muestra cómo usarlodescribe-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 identificador, la descripción, la categoría y los metadatos del cheque. Tenga en cuenta que el resultado está abreviado para facilitar la lectura.

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<br>\n<br>\n<b>Alert Criteria</b><br>\nYellow: No IAM users have been created for this account.\n<br>\n<br>\n<b>Recommended Action</b><br>\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 <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/IAMGettingStarted.html\" target=\"_blank\">Getting Started</a>. \n<br><br>\n<b>Additional Resources</b><br>\n<a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_Introduction.html\" target=\"_blank\">What Is IAM?</a>",
            "category": "security",
            "metadata": []
        }
    ]
}

Para obtener más información, consulte AWS Trusted Advisor en la Guía del usuario de AWS Support.

El siguiente ejemplo de código muestra cómo usarlorefresh-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 en la Guía del usuario de AWS Support.

El siguiente ejemplo de código muestra cómo usarloresolve-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 en la Guía del usuario de soporte de AWS .

  • Para API obtener más información, consulte ResolveCasela Referencia de AWS CLI comandos.