Message Queue will be discontinued on March 1, 2017. IBM Bluemix (Formerly SoftLayer) will discontinue support on January 31, 2017.

Fila de mensagens: introdução

Obtendo as credenciais da API

Após fazer um pedido para o serviço de Fila de mensagens, os terminais da API para o datacenter selecionado durante o processo de pedido podem ser localizados no Portal do cliente SoftLayer ao lado de seu nome do usuário, ID da conta e API, usando as etapas a seguir:

  • Abra https://control.softlayer.com/ no navegador da web e efetue login com seu nome do usuário e senha
  • No menu Serviços, clique em Fila de mensagens
  • Na lista Conta de fila de mensagens, clique na conta na lista que deseja usar. Na maioria dos casos, haverá uma conta para selecionar
  • O ID da conta pode ser localizado próximo à parte superior da página de detalhes da conta: intro-part1-account-detail.jpg
  • Diretamente abaixo do ID da conta, clique no link Visualizar credenciais
  • O nome do usuário e a chave da API serão exibidos no diálogo de credenciais:
    intro-part1-account-credentials.jpg

    Nota: se você tiver mais de uma conta do usuário na conta de cliente SoftLayer e desejar usar uma conta específica para interagir com a API da Fila de mensagens, simplesmente repita estas etapas efetuando login com essa conta do usuário.

Nos exemplos acima, nossas informações de conta para este exemplo são as seguintes:

  • ID da conta: 5yc2z
  • Nome do usuário: happycustomer
  • Chave da API: 98b0c8158e633d5c5ed63ad24584cadfa0e6e047c4c9e7e3adb3368aaa029640

Esses três itens serão necessários quando autenticarmos no serviço.

Autenticando

Agora que temos nossas credenciais, podemos começar a desenvolver nosso aplicativo. Para esta série de exemplo, vamos usar PHP.

require('softlayer-queue-php-client/src/SoftLayer/Messaging.php');
 
// Replace these values with your own.
define('QUEUE_ACCOUNT', '5yc2z');
define('QUEUE_USERNAME', 'happycustomer');
define('QUEUE_API_KEY', '98b0c8158e633d5c5ed63ad24584cadfa0e6e047c4c9e7e3adb3368aaa029640');
 
$messaging = new SoftLayer_Messaging();
 
if ($messaging->authenticate(QUEUE_ACCOUNT, QUEUE_USERNAME, QUEUE_API_KEY)) {
    echo "Welcome to the SoftLayer Message Queue!" . PHP_EOL;
}

Neste exemplo, simplesmente tentamos a autenticação. Se for bem-sucedida, deveremos ver a mensagem de boas-vindas.

Listando filas

Agora que autenticamos com sucesso, deveremos poder executar uma operação simples com relação à nossa conta, como obter uma lista de todas as filas criadas em nossa conta até o momento:

$queues = $messaging->queues();
echo "There are " . count($queues) . " queues on your account." . PHP_EOL;

Como esta é a primeira vez que usamos o serviço de fila, simplesmente seremos informados que temos zero filas até o momento -- mas é uma maneira simples de testar a API.

Verifique Fila de mensagens: explorando tópicos, vamos explorar filas em muito mais profundidade, e Fila de mensagens: explorando filas, que explicará casos de uso mais avançados por meio de uso de tópicos.