---
title: Docker Swarm Service Info
slug: homologacao-atmosphere/docker-swarm-service-info
description: Learn about the "docker_swarm_service_info" function, its requirements, and outputs. This document summarizes the function that retrieves information about Docker services in a Swarm Manager. Find out how to use this function to check the existence of a s
docTags: 
createdAt: 2021-03-17T19:49:39.000Z
---

## Resumo

- Retorna informações sobre os serviços docker de um Swarm Manager.

## Requisitos

- Docker API >= 1.24

## Parâmetros

| **Parâmetro**     | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários**                       |
| ----------------- | -------- | ---------------------------- | ------------------------------------- |
| name - *required* | string   |                              | O nome do serviço a ser inspecionado. |



Exemplos
--------

```yaml
# Exemplo: Obtenha informações de um serviço
  docker_swarm_service_info:
    name: myservice
  register: result
```



## Valores retornados

| **Chave** | **Tipo**   | **Retornado quando** | **Descrição**                                                                                                                                       |
| --------- | ---------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| exists    | boolean    | Sempre               | Retorna se o serviço existe.                                                                                                                        |
| service   | dictionary | Sempre               | Um dicionário que representa o estado atual do serviço. Corresponde à saída de inspeção de serviço do docker. Será nenhum se o serviço não existir. |