As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Fazer solicitações de AWS service (Serviço da AWS) usando AWS SDK para Ruby
Para acessar programaticamente os Serviços da AWS, os SDKs usam uma classe de cliente para cada AWS service (Serviço da AWS). Se seu aplicativo precisar acessar o Amazon EC2, por exemplo, seu aplicativo criará um objeto cliente do Amazon EC2 para interagir com esse serviço. Em seguida, você usa o cliente de serviço para fazer solicitações para esse AWS service (Serviço da AWS).
Para fazer uma solicitação a um AWS service (Serviço da AWS), primeiro você cria e configure um cliente de serviço. Para cada AWS service (Serviço da AWS) utilizado pelo seu código, ele tem seu próprio gem e tipo dedicado para interagir com ele. O cliente expõe um método para cada operação de API exposta pelo serviço.
Cada cliente de serviço exige uma Região da AWS e um provedor de credenciais. O SDK usa esses valores para enviar solicitações à região correta para seus recursos e para assinar solicitações com as credenciais corretas. Você pode especificar esses valores de modo programático no código ou fazer com que sejam carregados automaticamente do ambiente.
-
Ao instanciar uma classe de cliente, as credenciais da AWS devem ser fornecidas. Para acessar informações sobre a ordem em que o SDK verifica os provedores de autenticação, consulte Cadeia de provedores de credenciais.
-
O SDK tem uma série de locais (ou fontes) que ele confere para encontrar um valor para as configurações. Para obter detalhes, consulte Precedência de configurações.
O SDK para Ruby inclui classes de cliente que fornecem interfaces para os Serviços da AWS. Cada classe de cliente comoporta um AWS service (Serviço da AWS) específico e segue a convenção Aws::. Por exemplo, <service identifier>::ClientAws::S3::Client fornece uma interface para o serviço Amazon Simple Storage Service e Aws::SQS::Client fornece uma interface para o serviço Amazon Simple Queue Service.
Todas as classes de cliente de todos os Serviços da AWS são seguras para encadeamento.
Você pode passar opções de configuração diretamente para os construtores de cliente e recurso. Essas opções têm precedência sobre o ambiente e as configurações padrão Aws.config.
# using a credentials object ec2 = Aws::EC2::Client.new(region: 'us-west-2', credentials: credentials)
