Exemplos de Suporte usando o Tools for PowerShell V4 - Ferramentas da AWS para PowerShell (versão 4)
Ações

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Exemplos de Suporte usando o Tools for PowerShell V4

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V4 com o Suporte.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Add-ASACommunicationToCase.

Ferramentas para PowerShell V4

Exemplo 1: adiciona o corpo de uma comunicação por e-mail ao caso especificado.

Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CommunicationBody "Some text about the case"

Exemplo 2: adiciona o corpo de uma comunicação por e-mail ao caso especificado mais um ou mais endereços de e-mail contidos na linha CC do e-mail.

Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CcEmailAddress @("email1@address.com", "email2@address.com") -CommunicationBody "Some text about the case"

  • Para obter detalhes da API, consulte AddCommunicationToCase em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ASACase.

Ferramentas para PowerShell V4

Exemplo 1: retorna os detalhes de todos os casos de suporte.

Get-ASACase

Exemplo 2: retorna os detalhes de todos os casos de suporte desde a data e a hora especificadas.

Get-ASACase -AfterTime "2013-09-10T03:06Z"

Exemplo 3: retorna os detalhes dos primeiros 10 casos de suporte, inclusive aqueles que foram resolvidos.

Get-ASACase -MaxResult 10 -IncludeResolvedCases $true

Exemplo 4: retorna os detalhes do único caso de suporte especificado.

Get-ASACase -CaseIdList "case-12345678910-2013-c4c1d2bf33c5cf47"

Exemplo 5: retorna os detalhes dos casos de suporte especificados.

Get-ASACase -CaseIdList @("case-12345678910-2013-c4c1d2bf33c5cf47", "case-18929034710-2011-c4fdeabf33c5cf47")

  • Para obter detalhes da API, consulte DescribeCases em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ASACommunication.

Ferramentas para PowerShell V4

Exemplo 1: retorna todas as comunicações do caso especificado.

Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"

Exemplo 2: retorna todas as comunicações desde a meia-noite UTC de 1º de janeiro de 2012 para o caso especificado.

Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -AfterTime "2012-01-10T00:00Z"

  • Para obter detalhes da API, consulte DescribeCommunications em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ASAService.

Ferramentas para PowerShell V4

Exemplo 1: retorna todos os códigos de serviço, nomes e categorias disponíveis.

Get-ASAService

Exemplo 2: retorna o nome e as categorias do serviço com o código especificado.

Get-ASAService -ServiceCodeList "amazon-cloudfront"

Exemplo 3: retorna o nome e as categorias dos códigos de serviço especificados.

Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch")

Exemplo 4: retorna o nome e as categorias (em japonês) dos códigos de serviço especificados. Atualmente, os códigos de idioma inglês (“en”) e japonês (“ja”) são compatíveis.

Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch") -Language "ja"

  • Para obter detalhes da API, consulte DescribeServices em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ASASeverityLevel.

Ferramentas para PowerShell V4

Exemplo 1: retorna a lista de níveis de gravidade que podem ser atribuídos a um caso do AWS Support.

Get-ASASeverityLevel

Exemplo 2: retorna a lista de níveis de gravidade que podem ser atribuídos a um caso do AWS Support. Os nomes dos níveis retornam em japonês.

Get-ASASeverityLevel -Language "ja"

  • Para obter detalhes da API, consulte DescribeSeverityLevels em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ASATrustedAdvisorCheck.

Ferramentas para PowerShell V4

Exemplo 1: retorna a coleção de verificações do Trusted Advisor. Você deve especificar o parâmetro Language, que pode aceitar “en” para saída em inglês ou “ja” para saída em japonês.

Get-ASATrustedAdvisorCheck -Language "en"

O código de exemplo a seguir mostra como usar Get-ASATrustedAdvisorCheckRefreshStatus.

Ferramentas para PowerShell V4

Exemplo 1: retorna o status atual das solicitações de atualização para as verificações especificadas. Request-ASATrustedAdvisorCheckRefresh pode ser usado para solicitar que as informações de status das verificações sejam atualizadas.

Get-ASATrustedAdvisorCheckRefreshStatus -CheckId @("checkid1", "checkid2")

O código de exemplo a seguir mostra como usar Get-ASATrustedAdvisorCheckResult.

Ferramentas para PowerShell V4

Exemplo 1: retorna os resultados de uma verificação do Trusted Advisor. A lista de verificações disponíveis do Trusted Advisor pode ser obtida usando Get-ASATrustedAdvisorChecks. A saída é o status geral da verificação, a data e hora em que a verificação foi executada pela última vez e o ID de verificação exclusivo da verificação específica. Para que os resultados sejam exibidos em japonês, adicione o parâmetro -Language “ja”.

Get-ASATrustedAdvisorCheckResult -CheckId "checkid1"

O código de exemplo a seguir mostra como usar Get-ASATrustedAdvisorCheckSummary.

Ferramentas para PowerShell V4

Exemplo 1: retorna o resumo mais recente da verificação especificada do Trusted Advisor.

Get-ASATrustedAdvisorCheckSummary -CheckId "checkid1"

Exemplo 2: retorna os resumos mais recentes das verificações especificadas do Trusted Advisor.

Get-ASATrustedAdvisorCheckSummary -CheckId @("checkid1", "checkid2")

O código de exemplo a seguir mostra como usar New-ASACase.

Ferramentas para PowerShell V4

Exemplo 1: cria um caso no AWS Support Center. Os valores dos parâmetros -ServiceCode e -CategoryCode podem ser obtidos usando o cmdlet Get-ASAService. O valor do parâmetro -SeverityCode pode ser obtido usando o cmdlet Get-ASASeverityLevel. O valor do parâmetro -IssueType pode ser “customer-service” ou “technical”. Se for bem-sucedido, o número do caso do AWS Support será exibido. Por padrão, o caso será tratado em inglês. Para usar japonês, adicione o parâmetro -Language “ja”. Os parâmetros -ServiceCode, -CategoryCode, -Subject e -CommunicationBody são obrigatórios. 

New-ASACase -ServiceCode "amazon-cloudfront" -CategoryCode "APIs" -SeverityCode "low" -Subject "subject text" -CommunicationBody "description of the case" -CcEmailAddress @("email1@domain.com", "email2@domain.com") -IssueType "technical"

  • Para obter detalhes da API, consulte CreateCase em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Request-ASATrustedAdvisorCheckRefresh.

Ferramentas para PowerShell V4

Exemplo 1: solicita uma atualização para a verificação especificada do Trusted Advisor.

Request-ASATrustedAdvisorCheckRefresh -CheckId "checkid1"

  • Para obter detalhes da API, consulte RefreshTrustedAdvisorCheck em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Resolve-ASACase.

Ferramentas para PowerShell V4

Exemplo 1: retorna o estado inicial do caso especificado e o estado atual após a conclusão da chamada para resolvê-lo.

Resolve-ASACase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"

  • Para obter detalhes da API, consulte ResolveCase em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).